Docs

Technische Referenz

Verbinde Calberry mit Website und Werkzeugen; genaue Endpunktverträge stehen in der generierten API-Referenz.

Hier findest du Workspace- und Flow-Webhooks, Signaturprüfung, Embed und Integrationsrezepte. Ein Buchungslink heißt in der API Funnel. Kennungen und Ereignisnamen bleiben in beiden Sprachen gleich.

Endpunktverträge

Nutze die vorhandene generierte Referenz, statt Endpunktschemas aus einem Artikel zu übernehmen:

Die Basis-URL lautet https://api.calberry.ai; Ressourcenpfade beginnen mit /v1. Die Referenz nennt Scopes, Request-/Response-Schemas sowie den Status stabil oder Beta. Zum stabilen Umfang gehören Slots, Buchungen anlegen/verschieben/stornieren, Lead-Anlage und -Liste, Funnels lesen und Webhook-Verwaltung. Weitere freigegebene Operationen gelten als Beta, sofern die Referenz nichts anderes ausweist.

Authentifizierung und sichere Schreibzugriffe

API und Workspace-Webhooks erfordern Pro und die passende Workspace-Berechtigung. Inhaber/Admins verwalten Schlüssel unter Entwicklung → API. Speichere den Schlüssel bei der Ausgabe und vergib nur die benötigten Scopes. Die Schlüsselverwaltung selbst verlangt eine angemeldete Inhaber-/Admin-Session.

Private API-Schlüssel bleiben auf dem Server. Sie gehören weder ins Embed noch in Website-JavaScript, öffentliche Repositories oder URL-Parameter. Öffentliche Buchungs- und Embed-Routen verwenden einen getrennten Besucherablauf.

Sende bei Schreibzugriffen einen Idempotency-Key. Für die Wiederholung derselben Aktion mit denselben validierten Daten bleibt der Key gleich. Eine neue beabsichtigte Aktion bekommt einen neuen Key. Derselbe Key mit widersprüchlichen Daten führt zu einem Idempotenzkonflikt.

Verarbeite die dokumentierte Fehlerhülle und Rate-Limit-Antworten. Beachte Retry-After, falls vorhanden, paginiere Listen und nutze die dokumentierten Delta-Filter. Eine erfolgreiche Buchungsantwort und die abgeschlossene Google-Kalender-Synchronisation sind getrennte Ergebnisse.

Anbindung auswählen

Workspace-Webhooks liefern Ereignisse unabhängig von Sequenzen. WhatsApp ist demnächst verfügbar.

Auf dieser Seite