POST
/externalBooking/finalConfirmation
Diese Schnittstelle gehört zur Public API und liefert öffentlich
sichtbare Daten – ein API-Schlüssel ist nicht nötig.
Bucht einen Termin in einem einzigen Aufruf: Uhrzeit reservieren, Kundendaten speichern, Buchung abschließen und Bestätigungs-E-Mail versenden. Damit entfallen die Einzelschritte Buchung starten, Kundendaten zur Buchung hinzufügen und Buchungsabschluss. Terminspezifische Zusatzfelder, Kommentare und Zahlungen lassen sich auf diesem Weg nicht übergeben – dafür ist der schrittweise Ablauf gedacht.
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
OK | Der Termin ist gebucht, die Bestätigungs-E-Mail wurde versendet. | |
GIVEN | Der Termin konnte nicht gebucht werden – meist ist die Uhrzeit inzwischen vergeben. Fragen Sie die verfügbaren Zeiten neu ab. |
Fehlerfälle
| Status | Antwort | Ursache |
|---|---|---|
404 |
{"result":"locationNotFound"} |
Der Standort existiert nicht oder gehört nicht zu Ihrem Geschäft. |
Hinweise zur Verwendung
- Einwilligungen: Datenschutzerklärung und AGB gelten bei diesem Aufruf automatisch als akzeptiert. Holen Sie die Zustimmung des Kunden deshalb in Ihrer eigenen Anwendung ein, bevor Sie buchen.
- Keine Feldprüfung: Fehlerhafte Kundendaten werden nicht als eigene Antwort gemeldet. Prüfen Sie Pflichtangaben wie Name und Kontaktdaten vorab in Ihrer Anwendung.
Parameter
| Name | Übergabe |
|---|---|
servicerGroupId |
Body Pflicht |
Platzhalter{{servicerGroupId}}
ID des Standorts.
|
|
selectedProducts |
Body Pflicht |
Platzhalter{{selectedProducts}}
Komma-separierte Liste von Leistungs-IDs.
|
|
bookingGroups[0] |
Body Optional |
Platzhalter{{servicerId}}
ID des Mitarbeiters für die erste Position; leer für beliebiger Mitarbeiter.
|
|
date |
Body Pflicht |
Beispiel02.01.201909:00
Datum und Startzeit des Termins, z. B. aus Verfügbare Termine.
|
|
firstName |
Body Pflicht |
BeispielPetra
Vorname des Kunden.
|
|
lastName |
Body Pflicht |
BeispielLustig
Nachname des Kunden.
|
|
email |
Body Optional |
Beispielihre-adresse@example.com
E-Mail-Adresse. An sie geht die Buchungsbestätigung.
|
|
mobile |
Body Optional |
Beispiel0123456789
Mobilnummer des Kunden.
|
|
callback |
Body Optional |
| Name einer JavaScript-Funktion. Ist er gesetzt, kommt die Antwort als JSONP (application/javascript) statt als JSON. Erlaubt sind nur Funktionsnamen wie "meineFunktion" oder "app.callback". | |
Struktur zuletzt mit der Postman-Collection abgeglichen: 02.11.2026