Zum Inhalt springen

Die Terminbuchung-API, offen für all Ihre Tools

Token mit Berechtigungen, signierte Webhooks, OAuth-Anwendungen, Zapier und Make. Ihre Buchungen fließen dorthin, wo Sie arbeiten.

Eine Terminbuchung-API wird nötig, sobald Ihre Buchungen nicht nur im Buchungstool leben sollen: in einer Branchensoftware, einem Kundenportal, einem Data Warehouse oder einem Automatisierungstool. Ohne sie bleiben nur manueller Export und doppelte Dateneingabe.

Warum eine vollständige Terminbuchung-API

Artibox Calendar stellt eine öffentliche REST-API unter /api/v1 bereit: Terminarten, Verfügbarkeiten, Buchungen, Umfragen, Einmal-Links, Link-Versand, Webhooks. Sie folgt denselben Regeln wie die Anwendung: dieselben Rechte, dieselbe Trennung zwischen Organisationen, dieselbe Buchung unter Sperre. Was ein Token darf, darf auch sein Mitglied – nicht mehr.

Für Teams ohne Entwickler verbinden die Connectoren für Zapier und Make Ihre Termine ohne Code mit Ihren Tools. Und für HubSpot, Salesforce oder Pipedrive stehen die CRM-Integrationen bereits bereit.

So funktioniert es

  1. Erstellen Sie ein persönliches Token

    Wählen Sie seine Berechtigungen (Buchungen lesen, Terminarten schreiben …). Das Token beginnt mit rdv_pat_.

  2. Rufen Sie die API auf

    Senden Sie das Token im Header x-api-key. Außerhalb seiner Berechtigungen wird der Aufruf abgelehnt.

  3. Abonnieren Sie Ereignisse

    Hinterlegen Sie eine Webhook-Adresse und die Ereignisse, die Sie interessieren.

  4. Verfolgen Sie die Zustellungen

    Das Webhook-Protokoll zeigt jede Sendung; Sie können testen und erneut senden.

Eine API für den Produktivbetrieb

Token mit Berechtigungen

Jedes persönliche Token hat präzise Berechtigungen (Scopes): Nutzer lesen, Organisation lesen oder verwalten, Terminarten lesen oder schreiben, Verfügbarkeiten lesen, Buchungen lesen oder schreiben, Links schreiben, Webhooks verwalten. Ein Aufruf außerhalb der Berechtigungen erhält die Antwort 403. Ein Token kann nie ein anderes Token erstellen.

Klare Limits

Jedes Token kann 100 Aufrufe pro Minute ausführen. Listen sind nach Seitennummer paginiert. Erstellungen akzeptieren einen Header Idempotency-Key, der 24 Stunden gespeichert wird: Ein nach einem Netzwerkausfall wiederholter Aufruf erzeugt keine Dublette. Über die API erstellte Termine tragen die Herkunft „api“.

Dieselbe Engine wie die Buchungsseite

Eine über die API erstellte Buchung folgt denselben Regeln wie auf Ihrer Online-Buchungsseite: Vorlaufzeit, Pufferzeiten, Höchstzahl pro Tag, verbundene Kalender. Wurde das Zeitfenster gerade gebucht, ist die Antwort eine klare Ablehnung – nie eine Doppelbuchung.

Signierte Webhooks

Die Ereignisse

Ihre Anwendung wird benachrichtigt, wenn ein Termin erstellt, verschoben, storniert oder mit Status versehen wird, wenn ein Gast in einer Umfrage abstimmt oder eine Umfrage bestätigt wird und wenn sich eine Terminart ändert. Jede Sendung ist signiert (Header X-Signature): So prüfen Sie, dass sie wirklich von Artibox Calendar stammt.

Zuverlässige Zustellung

Antwortet Ihr Server nicht, wird die Zustellung erneut versucht, von einer Minute bis zu zwölf Stunden. Nach 20 aufeinanderfolgenden Fehlschlägen wird das Abonnement deaktiviert. Das Protokoll speichert 30 Tage an Zustellungen; eine Schaltfläche sendet ein Testereignis, eine andere stellt eine Zustellung erneut zu. Aus Sicherheitsgründen können Webhooks keine Adresse im internen Netzwerk ansteuern.

OAuth für Softwareanbieter

Sie entwickeln ein Tool, das andere Organisationen nutzen? Registrieren Sie eine OAuth-Anwendung unter Einstellungen › Integrationen. Ihre Nutzer sehen einen Zustimmungsbildschirm, dann erhält Ihre Anwendung einen Einmal-Code, 10 Minuten gültig und durch PKCE (S256) geschützt. Das Zugriffstoken gilt 2 Stunden; das Aktualisierungstoken rotiert bei jeder Nutzung, und seine Wiederverwendung sperrt den gesamten Zugriff. Jedes Mitglied kann einen Zugriff unter „Verbundene Anwendungen“ widerrufen.

Ohne Code: Zapier, Make und das Widget

Zapier und Make

Die Connectoren für Zapier und Make werden wie OAuth-Anwendungen verbunden: Lösen Sie bei jedem neuen Termin ein Szenario aus, versenden Sie einen Buchungslink aus einem anderen Tool oder suchen Sie einen Termin per E-Mail-Adresse.

Das Integrations-Kit

Das Skript widget.js fügt Ihrer Website einen Buchungsbutton oder -link hinzu. Die Buchung öffnet sich in einem eigenen Fenster. Tracking-Parameter (utm_*, gclid, fbclid, ref) werden am Termin gespeichert, und ein signierter Kontext kann die Buchung aus Ihrem Tool vorausfüllen.

Tarife und Sicherheit

Die API (persönliche Token, OAuth-Anwendungen) und die Connectoren für Zapier und Make sind Teil des Tarifs Pro; Webhooks gehören zum Tarif Team. Details finden Sie auf der Seite Preise. Von Token wird nur der Hash gespeichert, nie das Token im Klartext: siehe Sicherheit und DSGVO.

Für den Einstieg folgen Sie der Hilfe API und Token und Webhooks (auf Französisch). Bei der Wahl zwischen beiden Automatisierungstools hilft Zapier oder Make. Definitionen: API, Webhook.

Für wen

  • Vertriebsteams

    Termine mit Ihren Vertriebs- und Reporting-Tools verbinden.

  • Agenturen (FR)

    Die Terminbuchung in die Websites und Tools Ihrer Kunden integrieren.

  • Recruiting (FR)

    Vorstellungsgespräche direkt aus Ihrem Bewerbermanagementsystem anlegen.

  • Trainer (FR)

    Anmeldungen zu Sitzungen an Ihre Schulungsverwaltung übertragen.

Häufige Fragen

Wie authentifiziere ich mich bei der Terminbuchung-API?

Mit einem persönlichen Token (rdv_pat_…) oder einem OAuth-Zugriffstoken, gesendet im Header x-api-key. Jedes Token hat seine Berechtigungen.

Welche Aufruflimits gelten?

100 Aufrufe pro Minute und Token. Erstellungen akzeptieren einen Header Idempotency-Key, der 24 Stunden gespeichert wird.

Wie prüfe ich, dass ein Webhook wirklich von Artibox Calendar stammt?

Jede Sendung ist im Header X-Signature signiert. Prüfen Sie die Signatur, bevor Sie den Inhalt verarbeiten.

Was passiert, wenn mein Server nicht erreichbar ist?

Die Zustellung wird von einer Minute bis zu zwölf Stunden erneut versucht. Nach 20 Fehlschlägen wird das Abonnement deaktiviert; Sie können Zustellungen aus dem Protokoll, das 30 Tage gespeichert wird, erneut senden.

In welchem Tarif ist die API enthalten?

API, Zapier und Make ab dem Tarif Pro; Webhooks ab dem Tarif Team. Siehe Preise.

Verbinden Sie Ihre Termine mit Ihren Tools

Erstellen Sie kostenlos Ihr Konto und dann Ihr erstes API-Token.

Konto erstellen