Salt la conținutul principal
GET
Returnează orele de început ale intervalelor disponibile pentru o singură locație în fereastra solicitată. Intervalele sunt generate din open_hours al locației, fără datele blocate global / per locație și fără programările Aniva deja rezervate, astfel încât rezultatul reflectă ce pot rezerva concret pacienții tăi pe partea de client. Necesită scope-ul appointments_schedule. Locația trebuie să facă parte și din contextul de acces pe grupuri de locații al cheii tale API.
Folosește acest endpoint în loc să deduci disponibilitatea din câmpul static open_hours returnat de Listare locații — doar acest endpoint ține cont de programările active, excepțiile de program pe date specifice și preavizul minim de 12 ore din locațiile operate de Aniva. Fiecare interval returnat aici poate fi rezervat ca atare.
Răspunsurile conțin Cache-Control: private, max-age=30, stale-while-revalidate=60, deci un browser poate servi un răspuns din cache timp de până la ~30 de secunde — un interval rezervat în această fereastră poate părea încă disponibil până la următoarea reîmprospătare. Afișează conflictele și în momentul rezervării.

Parametri de cale

string
obligatoriu
Identificatorul locației (UUID). Folosește câmpul id din Listare locații.

Parametri de interogare

string
Începutul inclusiv al ferestrei în format YYYY-MM-DD (interpretat în timezone). Opțional. Valoarea implicită este astăzi când nu este furnizată nicio dată sau end_date − 30 days când este furnizat doar end_date. Datele din trecut sunt ajustate automat la ziua de astăzi.
string
Sfârșitul inclusiv al ferestrei în format YYYY-MM-DD (interpretat în timezone). Opțional. Valoarea implicită este astăzi + 30 de zile când nu este furnizată nicio dată sau start_date + 30 days când este furnizat doar start_date. Trebuie să fie egală cu sau după start_date și în limita a 90 de zile față de astăzi.
string
Fus orar IANA (de ex., Europe/Berlin) folosit pentru a interpreta start_date / end_date și a grupa intervalele pe date calendaristice. Opțional — implicit este fusul orar al locației. Orele de început ale intervalelor sunt redate întotdeauna ca momente UTC (Z) și nu se modifică în funcție de acest parametru — grila de intervale este proiectată întotdeauna din fusul orar al locației; parametrul afectează doar ziua calendaristică în care este grupat un interval. Intrările pe zile din răspuns acoperă exact start_date..end_date ca zile calendaristice în acest fus orar. Omite-l dacă nu afișezi selectorul în alt fus orar.

Răspuns

La succes, API-ul returnează 200 OK cu un singur obiect de disponibilitate.
string
obligatoriu
Identificatorul locației, preluat din cerere.
string
obligatoriu
Fusul orar IANA în care este redat răspunsul (de ex., Europe/Berlin) — preia parametrul de interogare timezone dacă este furnizat, altfel fusul orar al locației.
integer
Distanța în minute dintre orele de început ale intervalelor disponibile consecutive. Pasul grilei configurate pentru locație — fiecare interval din availability se aliniază pe această grilă. Este null doar când locația nu are o configurare de programare. Nu reprezintă durata programării: rezervările care se suprapun cu ore de început diferite nu intră în conflict; doar coliziunile la aceeași oră exactă de început contează pentru concurență.
array
obligatoriu
Intervale disponibile pe zile. Zilele fără intervale disponibile sunt omise pentru a păstra răspunsul compact. Fiecare intrare conține:

Răspunsuri de eroare