API Connector

Stufe: Agentur

Der API Connector holt Veranstaltungen aus einem externen System und hält sie auf deiner Website aktuell. Du pflegst das Programm dort, wo du es ohnehin pflegst, und die Website zieht nach.

Unterstützt wird derzeit die Schnittstelle von co*pilot.

Einschalten

Öffne Ensemble → Features, schalte API Connector ein und öffne an der Karte die Einstellungen.

Verbindung

Feld	Bedeutung
API-URL	Domain oder vollständige REST-Adresse der Schnittstelle
API-Token	nur nötig, wenn die Schnittstelle geschützt ist
Channel	freiwillig: der Channel-Slug für gefilterte Abfragen

Mit Verbindung testen prüfst du die Angaben. Vorschau zeigt, was übernommen würde.

Synchronisation

Einstellung	Auswahl
Intervall	stündlich, zweimal täglich oder täglich
Automatisch veröffentlichen	neue Veranstaltungen sofort als veröffentlicht anlegen
Bilder laden	Veranstaltungsbilder in die Mediathek herunterladen

Jetzt synchronisieren stößt einen Lauf von Hand an. Der Status nennt danach, wie viele Veranstaltungen neu, aktualisiert und unverändert sind.

Akteure aus Titeln erkennen

Mit Künstler aus Titeln extrahieren erkennt Ensemble Namen im Veranstaltungstitel und legt Akteure dazu an. Unter Reihen-Präfixe trägst du Zusätze ein, die vorher entfernt werden: Aus „K3: Name“ wird „Name“.

Externer Cronjob

Für Server, auf denen der WordPress-eigene Zeitplan unzuverlässig läuft: Der Connector hat einen REST-Endpunkt, den dein Hoster zu festen Zeiten per POST aufruft. Die Anfrage trägt das angezeigte Token im Header X-Ensemble-Token.

Zur Shortcode-Referenz

---