Freie Zeitfenster abrufen

Gibt verfügbare Buchungszeitfenster für einen Mitarbeiter, Standort und Leistung zurück.

Request

GET /api/oauth/v2/resource/booking/available-slots

Header

Header	Wert
Authorization	Bearer {access_token}

Query-Parameter

Parameter	Typ	Pflicht	Beschreibung
userId	string (UUID)	Ja	ID des Mitarbeiters
locationId	string (UUID)	Ja	ID des Standorts
serviceId	string (UUID)	Ja	ID der Leistung
startDate	string (ISO 8601)	Ja	Startdatum der Suche (z.B. 2026-04-01)
endDate	string (ISO 8601)	Nein	Enddatum der Suche (Standard: startDate + 7 Tage)

Erforderlicher Scope: appointments

Hinweis: Die API gibt maximal 50 Zeitfenster zurück, chronologisch sortiert.

Response

Erfolg (200 OK)

{
  "data": {
    "user": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Dr.",
      "firstName": "Maria",
      "lastName": "Huber",
      "abbreviation": "MH",
      "sex": 1,
      "email": "m.huber@praxis.at",
      "color": "#3498db",
      "isDoctor": true,
      "sort": 1,
      "isBookable": true,
      "showBookingWeeks": 4,
      "tenancies": []
    },
    "location": {
      "id": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
      "name": "Ordination Wien",
      "bookingName": "Wien Mitte",
      "abbreviation": "W",
      "color": "#2ecc71",
      "street": "Musterstraße 1",
      "zip": "1010",
      "city": "Wien",
      "country": "AT",
      "email": "office@praxis.at",
      "tel": "+43 1 234567",
      "telCode": "+43",
      "sort": 1,
      "bookable": true,
      "tenancies": []
    },
    "service": {
      "id": "c3d4e5f6-a7b8-9012-cdef-012345678901",
      "name": "Erstgespräch",
      "description": "Erstberatung 60 Minuten",
      "duration": 60,
      "durationBefore": 0,
      "durationAfter": 10,
      "directBooking": true,
      "isOnlineBookable": true,
      "price": "120.00",
      "color": "#e74c3c",
      "sort": 1,
      "tenancies": []
    },
    "slots": [
      {
        "start": "2026-04-02T09:00:00+02:00",
        "end": "2026-04-02T10:00:00+02:00"
      },
      {
        "start": "2026-04-02T10:30:00+02:00",
        "end": "2026-04-02T11:30:00+02:00"
      }
    ]
  }
}

Response-Felder

Feld	Typ	Beschreibung
data.user	object	Mitarbeiter (siehe Benutzer-Details)
data.location	object	Standort (siehe Standort-Details)
data.service	object	Leistung (siehe Leistung-Details)
data.slots[].start	string (ISO 8601)	Startzeit des Zeitfensters
data.slots[].end	string (ISO 8601)	Endzeit des Zeitfensters

Hinweis: Die Zeiten sind in der lokalen Zeitzone des Unternehmens mit UTC-Offset angegeben.

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/booking/available-slots?userId=b2c3d4e5-f6a7-8901-bcde-f01234567890&locationId=b2c3d4e5-f6a7-8901-bcde-f01234567890&serviceId=b2c3d4e5-f6a7-8901-bcde-f01234567890&startDate=2026-04-15T10%3A00%3A00&endDate=2026-04-15T10%3A00%3A00" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

userId *string

locationId *string

serviceId *string

startDate *string

endDate string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
400	validation_error	Pflichtparameter fehlt oder UUID ist ungültig
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope appointments nicht vorhanden
404	not_found	Mitarbeiter, Standort oder Leistung nicht gefunden