Kurse auf deiner eigenen Website zeigen
Am Ende holt deine Website deine veröffentlichten Kurse und Termine aus konerio und erfährt von jeder Änderung, ohne dass jemand etwas zweimal einträgt.
Wer das braucht
Nur wer neben konerio eine eigene Website betreibt, die dieselben Kurse und Termine zeigen soll. Wenn du deine Anmeldungen direkt in konerio abwickelst, musst du unter Einstellungen → Website-Anbindung nichts einrichten.
Die Seite richtet zwei Richtungen ein: was deine Website aus konerio abholt, und wie konerio ihr Änderungen meldet. Die erste Richtung ist immer da, die zweite richtest du ein.
Was deine Website abholt
Unter einer öffentlichen Adresse liegen alle veröffentlichten Kurse mit ihren Terminen, freien Plätzen und Preisen, als JSON und ohne Anmeldung. Was in der Kursliste noch Entwurf ist, ist nicht dabei, und Anmeldungen, Teilnehmerdaten und interne Kurse sind es auch nicht. Klick die Adresse auf der Seite an, dann siehst du deine eigenen Kurse so, wie deine Website sie bekommt.
Daneben steht eine Beispielantwort: ausgedacht, aber echt erzeugt, mit allen Sonderfällen wie online und vor Ort, abgesagt, mehrtägig, ausgebucht, mit und ohne Preis. Wer die Kursseite auf deiner Website baut, kann damit anfangen, bevor du in konerio den ersten Kurs veröffentlicht hast.
Die Adresse trägt ihre Version in sich. Eine Änderung, die bestehende Einbauten bricht, erscheint als neue Version, und die alte bleibt erreichbar; was auf deiner Website einmal läuft, bleibt also stehen.
Kurse und Termine einzeln lesen
Neben dem Vollabzug gibt es schmalere Abrufe für den, der auf deiner Website nur eine Liste braucht: die Kurse ohne ihre Termine, die Termine flach und chronologisch, ein einzelner Kurs über seine Kennung und ein einzelner Termin. Die Termine lassen sich nach Zeitraum und nach Kurs einschränken.
Ein eingeschränkter Abruf ist in der Antwort als unvollständig gekennzeichnet. Aus einem Ausschnitt darf deine Website nie schließen, dass ein Kurs oder Termin gelöscht wurde; das entscheidet nur der Vollabzug.
Einmal je Nacht vollständig abgleichen. Deine Website muss den ganzen Bestand einmal je Nacht von der Abrufadresse holen und mit ihrem eigenen abgleichen. Das ist Pflicht und nicht Kür: Damit steht sie auch dann richtig da, wenn eine einzelne Meldung nicht angekommen ist.
Das Änderungssignal
Ändert sich ein Kurs, ein Termin oder die Zahl der freien Plätze, ruft konerio eine Adresse auf deiner Website auf. Der Aufruf enthält keine Inhalte, sondern nur den Hinweis, was sich geändert hat; den aktuellen Stand holt sich deine Website danach selbst.
Die Einrichtung hat vier Schritte, und die Seite führt dich durch sie: Adresse hinterlegen, Geheimnis erzeugen, Testzustellung senden, und danach zeigt sie nur noch, ob es läuft. Das Geheimnis dient deiner Website dazu, die Herkunft eines Aufrufs zu prüfen; die Seite zeigt es genau einmal, danach nie wieder.
Fertige Bausteine zum Einbetten liefert konerio nicht. Die Seite auf deiner Website baut deine Agentur, dein Verein oder deine eigene IT, und alles, was sie dafür braucht, steht gesammelt im Block „Zum Weitergeben" oben rechts.
Wenn die Meldungen nicht ankommen
Scheitert eine Zustellung, steht auf der Seite „Letzte Zustellung fehlgeschlagen" mit dem Zeitpunkt und dem Grund, und die Kachel „Laufende Kontrolle" schlägt auf „Störung erkannt" um. Solange das so bleibt, hängt deine Website hinterher, bis der nächtliche Abgleich sie einholt.
Prüf zuerst, ob die Adresse auf deiner Website noch erreichbar ist und den Aufruf bestätigt. Danach schickst du auf der Seite eine neue Testzustellung; kommt sie an, ist die Störung weg.