Spring til hovedindhold
GET
Returnerer de bookbare starttidspunkter for en enkelt lokation i det ønskede tidsrum. Tidsslots genereres ud fra lokationens open_hours, hvor globale og lokationsspecifikke blokerede datoer springes over, og allerede bookede Aniva-tider trækkes fra, så resultatet afspejler det, dine patienter faktisk kan reservere på klientsiden. Kræver scopet appointments_schedule. Lokationen skal også være omfattet af din API-nøgles adgangskontekst for lokationsgrupper.
Brug dette endpoint i stedet for at udlede ledighed fra de statiske open_hours, som returneres af Vis lokationer — kun dette endpoint tager højde for aktuelle bookinger, datospecifikke undtagelser og minimumsvarslet på 12 timer på lokationer drevet af Aniva. Hvert tidsslot, der returneres her, kan bookes direkte.
Svar indeholder Cache-Control: private, max-age=30, stale-while-revalidate=60, så en browser kan levere et cachet svar i op til ~30 sekunder — et tidsslot, der bookes inden for det vindue, kan stadig se bookbart ud indtil næste opdatering. Vis også konflikter ved booking.

Path-parametre

string
påkrævet
Lokations-id (UUID). Brug det id, du får fra Vis lokationer.

Query-parametre

string
Inklusiv start på tidsrummet i YYYY-MM-DD (fortolket i timezone). Valgfri. Standard er i dag, når ingen af datoerne angives, eller end_date − 30 days, når kun end_date angives. Datoer i fortiden sættes automatisk til i dag.
string
Inklusiv slutning på tidsrummet i YYYY-MM-DD (fortolket i timezone). Valgfri. Standard er i dag + 30 dage, når ingen af datoerne angives, eller start_date + 30 days, når kun start_date angives. Skal ligge på eller efter start_date og inden for 90 dage fra i dag.
string
IANA-tidszone (f.eks. Europe/Berlin), som bruges til at fortolke start_date / end_date og gruppere tidsslots efter kalenderdato. Valgfri — standard er lokationens egen tidszone. Selve starttidspunkterne vises altid som UTC-tidspunkter (Z) og ændrer sig aldrig med denne parameter — tidsslot-nettet beregnes altid ud fra lokationens egen tidszone; parameteren påvirker kun, hvilken kalenderdag et tidsslot grupperes under. Dagsposterne i svaret dækker præcis start_date..end_date som kalenderdage i denne tidszone. Udelad den, medmindre du viser tidsvælgeren i en anden tidszone.

Svar

Ved succes returnerer API’et 200 OK med et enkelt ledighedsobjekt.
string
påkrævet
Gentaget lokations-id.
string
påkrævet
IANA-tidszonen, som svaret vises i (f.eks. Europe/Berlin) — gentager query-parameteren timezone, hvis den er angivet, ellers lokationens egen tidszone.
integer
Afstanden i minutter mellem på hinanden følgende bookbare starttidspunkter. Lokationens konfigurerede interval — hvert tidsslot i availability følger dette net. Kun null, når lokationen ikke har nogen tidsplanskonfiguration. Ikke et varighedsvindue for tiden: overlappende bookinger med forskellige starttidspunkter giver ikke konflikt; kun sammenfald med præcis samme starttidspunkt tæller med i samtidigheden.
array
påkrævet
Bookbare tidsslots pr. dag. Dage uden bookbare tidsslots udelades for at holde svaret kompakt. Hver post indeholder:

Fejlsvar