POST/api/v1/s2s/scheduling/providers/{providerId}/availability-rules
Create partner provider availability rule
Freigegebener Partner-Endpunkt aus dem stabilen OpenAPI-1.0.0-Vertrag.
Übersicht
Nutzen Sie den Endpunkt ausschließlich mit einem Partner-API-Schlüssel. Die Codebeispiele verwenden Platzhalter und die öffentliche Sandbox-Adresse.
- Methode
- POST
- Endpunkt
- /api/v1/s2s/scheduling/providers/{providerId}/availability-rules
- Authentifizierung
- X-API-Key
Anfrage
Parameter
- providerIdstring (uuid)pathErforderlich
- Provider identifier.
- Beispiel: 5cd4f03b-5c1d-406e-b834-35b4f635c1c3
- X-Correlation-IDstringheader
- Optional opaque request correlation ID for tracing API calls across systems. Billing audit paths persist only UUIDv4-shaped values and drop free-form values.
- Beispiel: 33333333-3333-4333-8333-333333333333
Request-Body
Erforderlich- dayOfWeekintegerErforderlich
- Weekday in JS/cron convention: 0 Sunday, 6 Saturday.
- Beispiel: 1
- endTimestringErforderlich
- End time in HH:mm.
- Beispiel: 12:00
- generateFromstring (date)Erforderlich
- First date for slot generation.
- Beispiel: 2026-05-13
- generateTostring (date)Erforderlich
- Last date for slot generation.
- Beispiel: 2026-06-12
- slotDurationinteger
- Slot duration in minutes.
- Beispiel: 30
- specialtySlugstringErforderlich
- Specialty slug.
- Beispiel: adipositas
- startTimestringErforderlich
- Start time in HH:mm.
- Beispiel: 08:30
- timezonestring
- IANA timezone.
- Beispiel: Europe/Berlin
- rulesarrayErforderlich
- Availability rules to create in one transaction.
- Beispiel: [{"dayOfWeek":1,"endTime":"12:00","generateFrom":"2026-07-01","generateTo":"2026-07-31","slotDuration":30,"specialtySlug":"adipositas","startTime":"08:30","timezone":"Europe/Berlin"},{"dayOfWeek":3,"endTime":"17:00","generateFrom":"2026-07-01","generateTo":"2026-07-31","slotDuration":30,"specialtySlug":"adipositas","startTime":"14:00","timezone":"Europe/Berlin"}]
- rules[].dayOfWeekintegerErforderlich
- Weekday in JS/cron convention: 0 Sunday, 6 Saturday.
- Beispiel: 1
- rules[].endTimestringErforderlich
- End time in HH:mm.
- Beispiel: 12:00
- rules[].generateFromstring (date)Erforderlich
- First date for slot generation.
- Beispiel: 2026-05-13
- rules[].generateTostring (date)Erforderlich
- Last date for slot generation.
- Beispiel: 2026-06-12
- rules[].slotDurationinteger
- Slot duration in minutes.
- Beispiel: 30
- rules[].specialtySlugstringErforderlich
- Specialty slug.
- Beispiel: adipositas
- rules[].startTimestringErforderlich
- Start time in HH:mm.
- Beispiel: 08:30
- rules[].timezonestring
- IANA timezone.
- Beispiel: Europe/Berlin
Vertrag
Der versionierte OpenAPI-Vertrag ist die verbindliche Quelle für Parameter, Request-Body und Response-Schemas.
Version
1.0.0
Erwartete Antwort
201 Created