POST/api/v1/s2s/pharmacy/rooms/{roomId}/exceptions

Create or replace a room exception

Freigegebener Partner-Endpunkt aus dem stabilen OpenAPI-1.10.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/pharmacy/rooms/{roomId}/exceptions
Authentifizierung
X-API-Key

Anfrage

Parameter

roomIdstring (uuid)pathErforderlich
Pharmacy consultation room identifier.
Beispiel: ac7515a2-0cf6-4f73-b20b-3b96f3c97c9d
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
datestring (date)Erforderlich
Date, or first date of a range.
Beispiel: 2026-10-19
endDatestring (date)
Range end. Only for RANGE_CLOSED (required there), not before date, at most 366 days in total.
Beispiel: 2026-10-21
impactVersionstring
SHA-256 impact version from a preview or a previous response. Optional for partners: without it the write proceeds; a stale value yields 409 ROOM_CALENDAR_IMPACT_STALE.
Beispiel: 00fa1de975d61372e9fb9919cdd0b999e2b5e301795a6ab403e2692b5bfe6162
kindstringErforderlich
Beispiel: DAY_CLOSED
reasonCodestring
Fixed reason code. No free text exists. Treat unknown values as unrecognized instead of failing; values may be added in a minor release.
Beispiel: VACATION
replacesExceptionIdstring (uuid)
Exception group this request replaces.
Beispiel: 4c1b8f9e-1d1f-4e3f-9a4b-6a2f1f0b2c11
windowsarray
Required for HOURS_CHANGED and EXTRA_OPENING (1 to 6 windows), forbidden otherwise.
windows[].endstringErforderlich
Window end, HH:mm in Europe/Berlin, after start; 24:00 ends the day.
Beispiel: 13:00
windows[].startstringErforderlich
Window start, HH:mm in Europe/Berlin.
Beispiel: 09:00

Vertrag

Der versionierte OpenAPI-Vertrag ist die verbindliche Quelle für Parameter, Request-Body und Response-Schemas.

Version

1.10.0

Erwartete Antwort

201 Created

OpenAPI 1.10.0 herunterladen