POST
/externalBooking/calcAppointmentTimes2
Diese Schnittstelle gehört zur Public API und liefert öffentlich
sichtbare Daten – ein API-Schlüssel ist nicht nötig.
Die JSON-Body-Variante von Terminzeiten (auch bereits belegte) (calcAppointmentTimes): liefert die Uhrzeiten eines Tages, unabhängig davon, ob sie bereits belegt sind. Im Unterschied zur Formular-Variante wird jede Leistung einzeln berechnet – die Antwort enthält die Uhrzeiten getrennt je Leistungs-ID, nicht für die Kombination aller Leistungen. Zusätzlich wird ein Feiertag an diesem Tag mitgeliefert.
Ein Mitarbeiter lässt sich in dieser Variante nicht vorgeben; berechnet wird immer für einen beliebigen Mitarbeiter.
Antwort
| Name | Typ | Beschreibung |
|---|---|---|
day | string | Der abgefragte Tag im Format TT.MM.JJJJHH:mm. |
specificDate | string | Name des Feiertags an diesem Tag, sonst leer. |
times | object | Je Leistungs-ID eine Liste der Uhrzeiten im Format HH:mm. |
Fehlerfälle
| Status | Antwort | Ursache |
|---|---|---|
500 |
[invalid:true] |
Der Standort existiert nicht oder gehört nicht zu Ihrem Geschäft. Achtung: Die Antwort ist in diesem Fall kein gültiges JSON. |
400 |
{"invalid":true} |
offset oder selectedProductsIds fehlt oder ist ungültig. |
variabel |
{…} |
Die Buchungsanfrage ist für eine der Leistungen nicht zulässig (z. B. Online-Buchung ausgeschaltet). Status und Inhalt wie bei calcAppointmentTimes. |
Header
| Name | Wert |
|---|---|
Content-Type |
application/json |
Request-Body (JSON)
Pflichtfelder
| Feld | Typ |
|---|---|
servicerGroupId |
Zahl |
Beispiel16
ID des Standorts.
|
|
selectedProductsIds |
Liste |
Beispiel[180611,180612]
IDs der Leistungen als Liste, aus der Leistungsabfrage (calcGroups). Achtung Schreibweise: selectedProductsIds - mit "s" nach "Products".
|
|
offset |
Text |
Beispiel02.01.2019
Abgefragter Tag im Format TT.MM.JJJJ.
|
|
Vollständiger Beispiel-Body
{
"servicerGroupId": 16,
"selectedProductsIds": [
180611,
180612
],
"offset": "02.01.2019"
}
Struktur zuletzt mit der Postman-Collection abgeglichen: 02.11.2026