POST
/externalBooking/calcAvailableAppointments2
Diese Schnittstelle gehört zur Public API und liefert öffentlich
sichtbare Daten – ein API-Schlüssel ist nicht nötig.
Diese Schnittstelle liefert die verfügbaren Uhrzeiten wie Verfügbare Termine (calcAvailableAppointments), erwartet die Daten aber als JSON-Body mit Content-Type: application/json statt als Formulardaten.
Es gibt zwei inhaltliche Unterschiede zur Formular-Variante:
- Jede Leistung einzeln: Die Leistungen aus
selectedProductIdswerden nicht als gemeinsame Buchung, sondern jeweils für sich berechnet. Die Antwort enthält deshalb je Leistungs-ID einen eigenen Block im selben Format wie beicalcAvailableAppointments. Für die freien Zeiten einer Kombination mehrerer Leistungen verwenden Sie die Formular-Variante. - Kein Mitarbeiter wählbar:
bookingGroupswird nicht ausgewertet; berechnet wird immer für einen beliebigen Mitarbeiter.
Ist eine der Leistungen nicht buchbar, bricht der Aufruf ab und liefert dieselbe Fehlerantwort wie calcAvailableAppointments. Ein ungültiger Standort ergibt Status 404 mit {"invalid":true}, fehlende Leistungs-IDs Status 400 mit derselben Antwort.
Header
| Name | Wert |
|---|---|
Content-Type |
application/json |
Request-Body (JSON)
Pflichtfelder
| Feld | Typ |
|---|---|
servicerGroupId |
Zahl |
Beispiel16
ID des Standorts, für den die freien Uhrzeiten berechnet werden.
|
|
selectedProductIds |
Liste |
Beispiel[180612]
IDs der Leistungen als Liste, aus der Leistungsabfrage (calcGroups). Jede Leistung wird einzeln berechnet.
|
|
offset |
Text |
Beispiel02.01.2019
Erster Tag des abgefragten Zeitraums im Format TT.MM.JJJJ.
|
|
Optionale Felder
| Feld | Typ |
|---|---|
numberOfDays |
Zahl |
Beispiel1
Anzahl der Tage ab "offset", für die verfügbare Uhrzeiten berechnet werden. Standard: 35 Tage.
|
|
bookingSource |
Text |
BeispielYour API
Freier Text, der die Herkunft der Anfrage kennzeichnet – zum Beispiel der Name Ihrer Anwendung. Sinnvollerweise derselbe Wert, der später bei der eigentlichen Buchung mitgeschickt wird.
|
|
Vollständiger Beispiel-Body
{
"servicerGroupId": 16,
"selectedProductIds": [
180612
],
"numberOfDays": 1,
"offset": "02.01.2019",
"bookingSource": "Your API"
}