Pro API & Webhooks
Mit der Pro API können Ihre eigene Website, App oder Tools Buchungen, Kundinnen und Kunden und mehr lesen und erstellen. Webhooks senden Ereignisse in dem Moment an Ihre Systeme, in dem sie eintreten. Beide stehen zur Verfügung, wenn Ihr Plan den API-Zugang einschliesst.
Einen API-Schlüssel erstellen#
- Öffnen Sie Einbetten & API in der Seitenleiste und scrollen Sie zu API-Zugang.
- Fügen Sie unter API-Schlüssel optional eine Bezeichnung hinzu (zum Beispiel „Website“) und wählen Sie Schlüssel erstellen.
- Kopieren Sie den Schlüssel sofort: Er wird nur einmal angezeigt.
Senden Sie den Schlüssel im Authorization-Header jeder Anfrage. Derselbe Abschnitt zeigt die Basis-URL, die Endpunkte und Beispielantworten. Vollständige API-Referenz öffnet die öffentliche Entwicklerdokumentation unter lorenly.com/developers.
Jeder Schlüssel zeigt, wann er zuletzt verwendet wurde. Widerrufen Sie einen Schlüssel, den Sie nicht mehr benötigen; alles, was ihn nutzt, hört sofort auf zu funktionieren. Behandeln Sie Schlüssel wie Passwörter.
Über die API erstellte Buchungen folgen denselben Regeln wie die Online-Buchung, etwa Öffnungszeiten und Personalverfügbarkeit.
Einen Webhook hinzufügen#
- Gehen Sie zu Einstellungen → Webhooks, öffnen Sie So funktioniert es, falls Webhooks für Sie neu sind, dann Endpunkt hinzufügen.
- Geben Sie Ihre Endpunkt-URL ein. Sie muss mit https:// beginnen.
- Aktivieren Sie die gewünschten Ereignisse, zum Beispiel Neue Buchung erstellt, Buchung verschoben oder geändert, Buchung storniert, Neuer Kunde, Neue Bewertung, Paket gekauft, Rechnung bezahlt oder Verkauf abgeschlossen.
- Wählen Sie Webhook hinzufügen und bewahren Sie Ihr Signing Secret auf. Nutzen Sie es, um zu prüfen, dass jede Zustellung tatsächlich von Lorenly stammt.
Testen und überwachen#
- Test senden liefert ein Beispielereignis an Ihren Endpunkt.
- Zustellungen ansehen listet die letzten Zustellungen und ihr Ergebnis auf, sodass Sie Fehlschläge erkennen können.
- Schalten Sie einen Webhook aus, ohne ihn zu löschen, oder wählen Sie Löschen.
Ohne Code einbetten#
Oben in Einbetten & API finden Sie ausserdem fertige Buchungswidgets und ein Bewertungswidget zum Einfügen in Ihre Website, siehe Ihren Buchungslink teilen oder einbetten.