Website-Anbindung einrichten
Deine Website übernimmt veröffentlichte Kurse und Termine aus konerio.
Website-Anbindung verstehen
Die Website-Anbindung liefert deine veröffentlichten Kurse und Termine an deine eigene Website, z. B. die Seite deiner Firma. Der Buchungs-Button deiner Website öffnet die Kaufseite bei konerio.
Du pflegst Kurse und Termine damit nur an einer Stelle. Die Darstellung auf der Website erstellt deine Agentur oder IT aus diesen Daten.
Website-Anbindung öffnen
Öffne Einstellungen → Integrationen & KI → Website-Anbindung.
Richte die Anbindung nur für eine eigene Website ein.
Die Seite zeigt zwei Richtungen. Mit der API-Abfrage ruft deine Website die Daten über eine Schnittstelle von konerio ab, mit dem Webhook informiert konerio deine Website über Änderungen.
Die API-Abfrage ist sofort verfügbar. Den Webhook richtest du separat ein.
Kurse und Termine abrufen
Die öffentliche Abrufadresse liefert veröffentlichte Kurse und Termine mit freien Plätzen und Preisen im Datenformat JSON, das Programme direkt einlesen.
Entwürfe aus der Kursliste, Teilnehmerdaten und interne Kurse sind nicht enthalten.
Öffne die Abrufadresse auf der Einstellungsseite.
Prüfe dort die Daten deiner veröffentlichten Kurse.
Verwende die mitgelieferten Buchungsadressen auf deiner Website.
Kurskennung und Buchung
Die Kurskennung wird ebenfalls übertragen. Bei Kursen ohne Kennung bleibt das entsprechende Feld leer.
Jeder Kurs und Termin enthält seine Buchungsadresse.
Zusätzlich wird angegeben, ob die Buchung aktuell abgeschlossen werden kann. Deine Website kann den Buchungs-Button entsprechend ein- oder ausblenden.
Gliederung übertragen
Wähle in der Karte „Modulgliederung in der API-Abfrage" die Option „Mit der Gliederung" oder „Ohne Gliederung".
Ohne eigene Auswahl gilt die Standardeinstellung „Ohne Gliederung".
Umfang
Mit der Gliederung erhält deine Website Modultitel, Reihenfolge und hinterlegte Stunden.
Lektionen, Videos, Dateien und Tests werden nicht übertragen.
Beispiel und Version
Auf der Einstellungsseite findest du zusätzlich eine Beispielantwort.
Die Abrufadresse enthält ihre Version. Änderungen mit nicht kompatibler Struktur erhalten eine neue Version.
Einzelne Daten abrufen
Neben dem vollständigen Abruf gibt es weitere Abrufe. Dazu gehören Kurse ohne Termine, einzelne Kurse und einzelne Termine.
Termine eingrenzen
Termine lassen sich außerdem nach Zeitraum und Kurs einschränken.
Für eine Liste der kommenden Termine hängst du das heutige Datum an die Adresse der Termine, im Format ?from=JJJJ-MM-TT.
Ohne Datum enthält die Liste auch vergangene Termine, jeweils als nicht mehr buchbar gekennzeichnet.
Ein eingeschränkter Abruf ist als unvollständig gekennzeichnet. Verwende nur den vollständigen Abruf, um entfernte Inhalte zu erkennen.
Parameter
Ungültige Filterparameter, also Zusätze wie ?from= in der Abrufadresse, führen zu einer Fehlermeldung mit dem betroffenen Parameter.
Parameter zur Zugriffsmessung verändern die Antwort nicht. Dazu gehören utm_source, utm_medium, utm_campaign, utm_term, utm_content, fbclid, gclid, msclkid und ref.
Auch _, v, cb, nocache und ts werden akzeptiert, wenn sie eine Zahl enthalten. Andere Werte führen zu einer Fehlermeldung.
Gleiche deine Website einmal pro Nacht vollständig mit dem Abruf ab. Dadurch werden auch Änderungen übernommen, deren Webhook-Aufruf nicht zugestellt wurde.
Termine gruppiert abrufen
Die Termine sind zusätzlich nach Jahr, Monat, Turnus, Bereich und Kurs gruppiert abrufbar.
Für einen einzelnen Bereich verwendest du die Kennung des Bereichs in der Abrufadresse. Der Abruf enthält dann die Termine dieses Bereichs einschließlich aller Unterbereiche.
Ohne Turnusse oder Bereiche bleiben die Termine trotzdem vollständig im Abruf enthalten.
Auch in der flachen Terminliste enthält jeder Termin seine Turnusse, im Feld effective_terms. Das sind seine eigenen und ohne eigene die seines Kurses; ohne Turnus bleibt die Liste leer.
Webhook einrichten
Der Webhook informiert deine Website über relevante Änderungen. Er enthält die Art der Änderung, den Zeitpunkt und die Kennung des betroffenen Kurses oder Termins.
Die Inhalte ruft deine Website danach per API-Abfrage ab.
Hinterlege die Adresse deiner Website für den Webhook.
Erzeuge anschließend das dafür vorgesehene Secret, einen geheimen Schlüssel, mit dem deine Website prüft, dass ein Aufruf von konerio kommt.
Sende eine Testzustellung an deine Website.
Prüfe danach den angezeigten Zustand der Anbindung.
Das Secret wird auf der Seite nur einmal angezeigt. Gib die Angaben aus „Übergabe an die Website-Entwicklung" an deine Agentur oder IT weiter.
Konerio stellt dafür keine fertigen Einbettungsbausteine bereit.
Zustellung prüfen
Bei einer fehlgeschlagenen Zustellung zeigt die Seite Zeitpunkt und Grund an. Deine Website kann bis zum nächsten vollständigen Abgleich einen älteren Stand zeigen.
Prüfe zuerst die hinterlegte Adresse deiner Website. Sende danach eine neue Testzustellung und kontrolliere den Zustand erneut.