Endpoints / getSlots

getSlots

Freie Termine abfragen

Freie Termin-Slots für eine Leistung in einem Zeitraum.

HTTP Request

POST https://dev.vitabyte.ch/v1/booking/getSlots
Auth basicAuth apiKey

Request Parameters

Parameter Pflicht Typ Beispiel / Default
serviceid

Leistung aus getServices. Fehlt sie, kommt "Service-ID missing.".

 required integer
54
provider

0 = alle Behandler.

 optional integer
default: 0
duration

Dauer in Minuten; 0 = Default-Dauer der Leistung.

 optional integer
default: 0
30
from

Beginn des Suchfensters.

 optional string
2026-06-01
to

Ende des Suchfensters.

 optional string
2026-06-30

Response Parameters

Envelope: { status, msg, result }. Die Slot-Felder entsprechen dem, was die Onlinebuchung der Website produktiv verarbeitet.

Field Typ Beschreibung
ymd string Tag des Slots im Format YYYYMMDD
from integer Beginn als Unix-Timestamp
to integer Ende als Unix-Timestamp
provider integer Behandler zum Slot
location integer Standort zum Slot

Demo

Referenz und Beispiele stammen aus der internen API-Collection — die OpenAPI-Spec deckt diesen Endpoint noch nicht ab.

POST https://dev.vitabyte.ch/v1/booking/getSlots
Payload
{
    "serviceid": 54,
    "provider": 0,
    "duration": 30,
    "from": "2026-06-01",
    "to": "2026-06-30"
}
Response
{
    "status": true,
    "msg": "Success",
    "result": [
        {
            "ymd": "20260601",
            "from": 1780297200,
            "to": 1780299000,
            "provider": 12,
            "location": 0
        },
        {
            "ymd": "20260601",
            "from": 1780299000,
            "to": 1780300800,
            "provider": 12,
            "location": 0
        },
        {
            "ymd": "20260602",
            "from": 1780383600,
            "to": 1780385400,
            "provider": 14,
            "location": 0
        }
    ]
}