Ugrás a fő tartalomhoz
A helyszín egy fizikai tesztközpont, ahol egészségügyi szakemberek végeznek vérvételt. A helyszín id azonosítóját használod a practitioner időpontok foglalásához.
Az API-kulcsod csak a partneri hozzáférési körödbe tartozó helyszíneket adja vissza. Használd a GET /api/v1/locations végpontot a számodra elérhető összes helyszín listázásához.
A location.* webhook értesít, ha egy helyszín megjelenik, megváltozik vagy megszűnik.

Mezők

string
kötelező
A helyszín UUID azonosítója. Ezt add meg location_id értékként időpont létrehozásakor.
string
kötelező
A helyszín megjelenített neve.
string
A helyszínt üzemeltető klinika vagy cég. Lehet null.
string
Utcanév, házszám nélkül. Lehet null.
string
Házszám. Lehet null.
string
Kiegészítő címsor — c/o, épület vagy emelet. Lehet null.
string
Város. Lehet null.
string
Állam vagy tartomány (a városhoz kapcsolt állam alapján feloldva). Lehet null, ha a városhoz nincs kapcsolt állam.
string
A tartomány ISO 3166-2 kódja az ország-előtag nélkül (pl. BW Baden-Württemberg esetén). Lehet null.
string
Irányítószám. Lehet null.
string
Az ország teljes neve (pl. Germany). Lehet null.
string
Kétbetűs országkód az ISO 3166-1 alpha-2 szabvány szerint (pl. DE, US). Lehet null.
string
A helyszín IANA időzóna-azonosítója (pl. Europe/Berlin, America/New_York). Ezzel jelenítsd meg az ütemezett időpontokat a megfelelő helyi időben. Lehet null.
number
A cím szélességi foka decimális fokban (WGS 84). Lehet null.
number
A cím hosszúsági foka decimális fokban (WGS 84). Lehet null.
string
A helyszín telefonszáma. Lehet null.
string
A helyszín e-mail-címe. Lehet null.
string
A helyszín weboldalának URL-je. Lehet null.
string
Közvetlen link a helyszínhez a Google Mapsen. Lehet null.
string
A helyszínről készült fotó URL-je. Lehet null.
object
A helyszín heti nyitvatartása. A hét napjait jelölő kulcsok (monday–sunday) egy-egy { open, close } időtartományokat tartalmazó tömbre mutatnak HH:MM (24 órás) formátumban. Az üres tömb azt jelenti, hogy a helyszín aznap zárva van. Lehet null, ha a helyszínhez nem érhető el nyitvatartás.
string
kötelező
A vérvétel alapértelmezett módja az itteni időpontokon, ha az időpont nem ad meg saját draw_method értéket: capillary (ujjbegyből vagy felkarból, mikrocsövekbe) vagy venous (vénából, csövekbe).
string[]
kötelező
Azok a vérvételi módok, amelyekhez a helyszín tart készleten mintavételi tartályokat, rendezve. Egy itteni időpont draw_method értéke csak ezek közül valamelyik lehet.
Mindig a timezone mező segítségével alakítsd át a scheduled_at dátum- és időértékeket helyi időre, mielőtt megjeleníted őket a pácienseknek vagy a személyzetnek.

Elérhetőség

A fenti open_hours mező a statikus heti nyitvatartási rendet írja le. A valódi, foglalható idősávok megjelenítéséhez – és a meglévő Aniva időpontokkal való dupla foglalás elkerüléséhez – hívd meg a Get Availability végpontot a helyszínre, és add át neki a megjeleníteni kívánt dátumtartományt. Ez a végpont a mérvadó forrás minden foglalási felülethez: kiterjeszti az open_hours értékeket a helyszín idősávrácsára, alkalmazza a dátumhoz kötött kivételeket, levonja a már lefoglalt időpontokat, és figyelembe veszi a minimális előzetes határidőt.

Kiskereskedelmi árak

A gyógyszertár saját árat állít be minden olyan panelhez és egyedi biomarkerhez, amelyet betérő ügyfeleknek értékesít. Egy árat csak azután látsz, hogy a gyógyszertár közzétette. A List Retail Prices minden olyan helyszínre visszaadja őket, amelyet olvashatsz, a Get Retail Prices pedig egy helyszínre. Mindkettőhöz szükséges a retail_prices_view scope; a locations_view nem tartalmazza őket. Kérd mindkét scope-ot ugyanazokra a helyszínekre. A location.retail_prices.updated webhook értesít, ha egy ár megváltozik. A location.created és a location.deactivated jelzi, amikor egy helyszín létrejön vagy megszűnik. Az, hogy egy helyszín mely paneleket kínálja, később is eljuthat hozzád, mint egy árváltozás, ezért naponta egyszer olvasd ki újra a List Retail Prices végpontot.

Példa helyszín