Přejít na hlavní obsah
Odběrové místo je fyzické testovací centrum, kde zdravotníci provádějí odběry krve. Pomocí id odběrového místa plánuješ termíny typu practitioner.
Tvůj API klíč vrací jen odběrová místa v rámci tvého partnerského přístupu. Pomocí GET /api/v1/locations vypíšeš všechna odběrová místa, která máš k dispozici.
Webhook location.* tě upozorní, když odběrové místo přibude, změní se nebo zmizí.

Pole

string
povinné
UUID odběrového místa. Při vytváření termínu ho předej jako location_id.
string
povinné
Zobrazovaný název odběrového místa.
string
Klinika nebo společnost provozující odběrové místo. Může být null.
string
Název ulice bez čísla domu. Může být null.
string
Číslo domu. Může být null.
string
Doplňující řádek adresy — c/o, budova nebo patro. Může být null.
string
Město. Může být null.
string
Stát nebo provincie (určeno přes stát propojený s městem). Může být null, když město nemá propojený stát.
string
Kód státu podle ISO 3166-2 bez předpony země (např. BW pro Baden-Württemberg). Může být null.
string
PSČ nebo ZIP kód. Může být null.
string
Celý název země (např. Germany). Může být null.
string
Dvoupísmenný kód země podle ISO 3166-1 alpha-2 (např. DE, US). Může být null.
string
Identifikátor časového pásma IANA pro pobočku (např. Europe/Berlin, America/New_York). Použij ho k zobrazení naplánovaných časů ve správném místním čase. Může být null.
number
Zeměpisná šířka adresy v desetinných stupních (WGS 84). Může být null.
number
Zeměpisná délka adresy v desetinných stupních (WGS 84). Může být null.
string
Telefonní číslo pobočky. Může být null.
string
E-mailová adresa pobočky. Může být null.
string
URL webu pobočky. Může být null.
string
Přímý odkaz na pobočku na Google Maps. Může být null.
string
URL fotografie pobočky. Může být null.
object
Týdenní otevírací doba pobočky. Každý klíč dne v týdnu (monday–sunday) obsahuje pole časových rozmezí { open, close } ve formátu HH:MM (24 h). Prázdné pole znamená, že je pobočka ten den zavřená. Může být null, pokud otevírací doba pobočky není k dispozici.
string
povinné
Jak se zde při termínu odebírá krev, pokud termín nenastaví vlastní draw_method: capillary (z bříška prstu nebo paže, do mikrozkumavek) nebo venous (ze žíly, do zkumavek).
string[]
povinné
Metody odběru, pro které má místo skladem odběrové nádobky, seřazené. Termín na tomto místě může jako draw_method nastavit jen jednu z nich.
Vždy použij pole timezone k převodu dat a časů scheduled_at na místní čas, než je zobrazíš pacientům nebo personálu.

Dostupnost

Pole open_hours výše popisuje statický týdenní rozvrh otevírací doby. Pokud chceš zobrazit skutečně rezervovatelné sloty – a vyhnout se duplicitním rezervacím s existujícími termíny Aniva – zavolej pro danou pobočku Get Availability a předej mu rozmezí dat, které chceš zobrazit. Tento endpoint je správným zdrojem pravdy pro jakékoli rezervační UI: rozepíše open_hours do mřížky slotů pobočky, zohlední výjimky pro jednotlivá data, odečte už rezervované termíny a uplatní minimální předstih.

Maloobchodní ceny

Lékárna si sama nastavuje cenu pro každý panel i pro každý jednotlivý biomarker, který prodává příchozím zákazníkům. Cenu uvidíš až poté, co ji lékárna zveřejní. List Retail Prices je vrátí pro každou pobočku, kterou můžeš číst, a Get Retail Prices je vrátí pro jednu pobočku. Oba vyžadují scope retail_prices_view; locations_view je nezahrnuje. Požádej o oba scopy pro stejné pobočky. Webhook location.retail_prices.updated ti dá vědět, když se cena změní. location.created a location.deactivated ti dají vědět, když pobočka přibude nebo zmizí. Změna v tom, jaké panely pobočka nabízí, k tobě může dorazit později než změna ceny, proto jednou denně znovu načti List Retail Prices.

Příklad pobočky