Modul "API (Schnittstelle)"

Termine direkt aus Ihrer eigenen Anwendung heraus buchen.

Mit der REST-API fragen Ihre Website, Ihr Kundenportal, Ihre App oder Ihr CRM-System freie Termine ab und legen Buchungen an. Ihre Kunden bleiben dabei in Ihrer gewohnten Umgebung und müssen den Terminplaner nicht selbst aufrufen.

Ihre Vorteile auf einen Blick

  • Ihr Design, Ihr Ablauf: Die Buchungsstrecke sieht genau so aus, wie Sie es möchten.
  • Alles an einem Ort: Termine landen sofort im Terminplaner, inklusive der gewohnten Benachrichtigungs-E-Mails.
  • Schnell umgesetzt: Sechs Aufrufe im JSON-Format bilden den kompletten Buchungsablauf ab.
  • Sicher angebunden: Die Anmeldung erfolgt per Token, das Sie selbst erzeugen und jederzeit erneuern.

Anwendungsbeispiele

Eigene Buchungsstrecke

Die Terminbuchung fügt sich nahtlos in das Design Ihrer Website ein.

Mobile App

Ihre Kunden buchen Termine direkt in Ihrer eigenen App.

CRM und Praxissoftware

Termine werden aus der Anwendung heraus angelegt, mit der Sie täglich arbeiten.

Shop und Kundenportal

Der Termin wird direkt im Bestellprozess oder im Mitgliederbereich vergeben.

KI-Telefonassistent

Ein Sprachassistent nimmt Anrufe entgegen, nennt freie Termine und bucht sie im Gespräch über die API.

So läuft eine Buchung ab

1. Kalender

Ihre Anwendung fragt die verfügbaren Terminkalender ab und wählt den passenden aus.

2. Termingrund

Zu jedem Kalender liefert die API die Leistungen mit Beschreibung und Dauer.

3. Tag

Zurückgegeben werden nur die Tage, an denen tatsächlich ein Termin frei ist.

4. Uhrzeit

Für den gewählten Tag erhalten Sie alle freien Terminzeiten.

5. Formularfelder

Welche Angaben Sie von Ihren Kunden abfragen, legen Sie im Terminplaner fest. Die API nennt die passenden Felder.

6. Buchung

Der Termin wird gebucht, Kundendatensatz und Termin werden dabei angelegt.

Über die API gebuchte Termine erscheinen unmittelbar im Terminplaner und lösen die gewohnten Benachrichtigungs-E-Mails aus.

Beispiel: Termin buchen

Anfrage

POST /api/bookings
Authorization: Bearer apm_ihr-token
Content-Type: application/json

{
    "schedule": 1,
    "reason": 1,
    "slot": "2026-05-23 09:00:00",
    "submission": {
        "first_name": "Hans",
        "last_name": "Pitt",
        "email": "hans.pitt@example.com"
    }
}

Antwort

{
    "booking_id": 142,
    "booking_details_id": "a3f8c2d1e5b6",
    "user_id": 87,
    "slot": "2026-05-23T09:00:00Z"
}

Sicherheit und Betrieb

  • Anmeldung per Token
    Das Token erzeugen Sie selbst im Administrationsbereich unter Konfiguration → API.
  • Nur einmal sichtbar
    Das Token wird ein einziges Mal angezeigt und im System ausschließlich als Hash gespeichert.
  • Jederzeit erneuerbar
    Erzeugen Sie ein neues Token, verliert das bisherige sofort seine Gültigkeit.
  • 300 Anfragen pro Minute
    Ausreichend Spielraum für den laufenden Betrieb Ihrer Anwendung.

Weitere Informationen

Anleitung

Schritt für Schritt von der Aktivierung über das Token bis zur ersten Buchung, mit Beispielen für jeden Aufruf.

Zur Anleitung

Referenz

Alle Aufrufe mit Parametern, Statuscodes und Schemas – dazu die Beschreibung als OpenAPI-Datei.

Zur Referenz

Webhooks

Die Gegenrichtung: Neue, abgesagte und verschobene Termine automatisch an eine externe Anwendung senden.

Weitere Informationen

Was ist eine API?

Eine kurze Erklärung der Programmierschnittstelle und ihrer Möglichkeiten im Glossar.

Zum Glossar

Bereit für mehr Umsatz und weniger Aufwand?

Kommen Sie zu Appointmind für Wachstum und Erfolg.

Weitere Module anzeigen.