id-ul unei locații pentru a face programări de tip practitioner.
Cheia ta API returnează doar locațiile din contextul tău de acces ca partener. Folosește
GET /api/v1/locations pentru a lista toate locațiile disponibile pentru tine.location.* te anunță când o locație apare, se modifică sau dispare.
Câmpuri
UUID-ul locației. Trimite această valoare ca
location_id atunci când creezi o programare.Statul sau provincia (obținut prin statul asociat orașului). Poate fi null atunci când orașul nu
are un stat asociat.
Codul ISO 3166-2 al statului, fără
prefixul de țară (de ex.,
BW pentru Baden-Württemberg). Poate fi null.Codul de țară din două litere conform ISO 3166-1 alpha-2
(de ex.,
DE, US). Poate fi null.Identificatorul de fus orar IANA al locației (de ex.,
Europe/Berlin, America/New_York). Folosește-l
pentru a afișa orele programate la ora locală corectă. Poate fi null.Programul săptămânal al locației. Fiecare cheie a zilei săptămânii (
monday–sunday) corespunde
unui array de intervale orare { open, close } în format HH:MM (24 h). Un array gol înseamnă că
locația este închisă în ziua respectivă. Poate fi null dacă programul nu este disponibil pentru locație.Modul în care se recoltează sângele la o programare aici, dacă programarea nu setează propriul
draw_method: capillary (din vârful degetului sau din partea superioară a brațului, în
microtuburi) sau venous (din venă, în eprubete).Metodele de recoltare pentru care locația are recipiente pe stoc, sortate. O programare aici
poate seta doar una dintre acestea ca
draw_method.Disponibilitate
Câmpulopen_hours de mai sus descrie programul săptămânal static. Pentru a afișa intervale reale care pot fi rezervate — și pentru a evita suprapunerea cu programările Aniva existente — apelează Obține disponibilitatea pentru locație și trimite intervalul de date pe care vrei să îl afișezi. Acest endpoint este sursa corectă de adevăr pentru orice interfață de programare: extinde open_hours pe grila de intervale a locației, aplică excepțiile pe date specifice, scade programările deja făcute și aplică preavizul minim.
Prețuri cu amănuntul
O farmacie își stabilește propriul preț pentru fiecare panel și pentru fiecare biomarker individual pe care îl vinde clienților din farmacie. Vezi un preț abia după ce farmacia îl publică. Listează prețurile cu amănuntul le returnează pentru fiecare locație pe care o poți citi, iar Obține prețurile cu amănuntul le returnează pentru o singură locație. Ambele necesită scope-ulretail_prices_view; locations_view nu le include.
Solicită ambele scope-uri pentru aceleași locații.
Un webhook location.retail_prices.updated te anunță când se schimbă un preț.
location.created și location.deactivated te anunță când apare sau dispare o locație. O modificare a
panelurilor oferite de o locație poate ajunge la tine mai târziu decât o modificare de preț, așa că
citește din nou Listează prețurile cu amănuntul o dată pe zi.