Pāriet uz galveno saturu
GET
Atgriež vienas vietas rezervējamu laiku sākumus pieprasītajā laika posmā. Laiki tiek ģenerēti no vietas open_hours, izlaižot globālos un konkrētās vietas bloķētos datumus un atņemot jau rezervētus Aniva pierakstus, tāpēc rezultāts atspoguļo to, ko tavi pacienti reāli var rezervēt klienta pusē. Nepieciešams tvērums appointments_schedule. Vietai jāietilpst arī tavas API atslēgas vietu grupas piekļuves kontekstā.
Izmanto šo galapunktu, nevis aprēķini pieejamību no statiskā open_hours, ko atgriež Vietu saraksts — tikai šis galapunkts ņem vērā aktuālās rezervācijas, grafika izņēmumus konkrētiem datumiem un 12 stundu minimālo iepriekšējo pieteikšanās laiku Aniva pārvaldītajās vietās. Katrs šeit atgrieztais laiks ir uzreiz rezervējams.
Atbildes satur Cache-Control: private, max-age=30, stale-while-revalidate=60, tāpēc pārlūkprogramma var pasniegt kešotus datus līdz ~30 sekundēm — šajā logā rezervēts laiks līdz nākamajai atsvaidzināšanai joprojām var rādīties kā pieejams. Apstrādā konfliktus arī rezervēšanas brīdī.

Ceļa parametri

string
obligāts
Vietas identifikators (UUID). Izmanto id no Vietu saraksts.

Vaicājuma parametri

string
Laika posma sākums (ieskaitot) formātā YYYY-MM-DD (interpretēts timezone laika joslā). Neobligāts. Pēc noklusējuma šodiena, ja nav norādīts neviens datums, vai end_date − 30 days, ja norādīts tikai end_date. Pagātnes datumi nemanāmi tiek pielīdzināti šodienai.
string
Laika posma beigas (ieskaitot) formātā YYYY-MM-DD (interpretēts timezone laika joslā). Neobligāts. Pēc noklusējuma šodiena + 30 dienas, ja nav norādīts neviens datums, vai start_date + 30 days, ja norādīts tikai start_date. Jābūt vienādam ar start_date vai vēlākam un 90 dienu robežās no šodienas.
string
IANA laika josla (piem., Europe/Berlin), ko izmanto start_date / end_date interpretēšanai un laiku grupēšanai pa kalendāra datumiem. Neobligāta — pēc noklusējuma tiek izmantota pašas vietas laika josla. Paši laiku sākumi vienmēr tiek attēloti kā UTC brīži (Z) un ar šo parametru nekad nemainās — laiku režģis vienmēr tiek projicēts no pašas vietas laika joslas; parametrs ietekmē tikai to, kurai kalendāra dienai laiks tiek pieskaitīts. Dienu ieraksti atbildē aptver tieši start_date..end_date kā kalendāra dienas šajā laika joslā. Izlaid to, ja vien laika izvēlni neattēlo citā laika joslā.

Atbilde

Veiksmīga pieprasījuma gadījumā API atgriež 200 OK ar vienu pieejamības objektu.
string
obligāts
Atgrieztais vietas identifikators.
string
obligāts
IANA laika josla, kurā attēlota atbilde (piem., Europe/Berlin) — atkārto vaicājuma parametru timezone, ja tas ir norādīts, pretējā gadījumā izmanto pašas vietas laika joslu.
integer
Atstarpe minūtēs starp secīgu rezervējamu laiku sākumiem. Vietai konfigurētais režģa solis — katrs laiks masīvā availability atbilst šim režģim. null tikai tad, ja vietai nav plānošanas konfigurācijas. Tas nav pieraksta ilguma logs: pārklājošas rezervācijas ar atšķirīgiem sākuma laikiem nekonfliktē; pie vienlaicīguma tiek skaitītas tikai precīzas sākuma laika sakritības.
array
obligāts
Rezervējamie laiki pa dienām. Dienas bez rezervējamajiem laikiem tiek izlaistas, lai datu apjoms būtu mazāks. Katram ierakstam ir:

Kļūdu atbildes