Hopp til hovedinnhold
En lokasjon er et fysisk testsenter der helsepersonell utfører blodprøvetaking. Du bruker lokasjonens id for å bestille practitioner-timer.
API-nøkkelen din returnerer bare lokasjoner innenfor partnertilgangen din. Bruk GET /api/v1/locations for å liste opp alle lokasjoner som er tilgjengelige for deg.
En location.*-webhook gir deg beskjed når en lokasjon dukker opp, endres eller forsvinner.

Felter

string
påkrevd
UUID for lokasjonen. Send denne som location_id når du oppretter en time.
string
påkrevd
Visningsnavn for lokasjonen.
string
Klinikk eller selskap som driver lokasjonen. Kan være null.
string
Gatenavn, uten husnummer. Kan være null.
string
Husnummer. Kan være null.
string
Ekstra adresselinje — c/o, bygning eller etasje. Kan være null.
string
By. Kan være null.
string
Delstat eller provins (hentet via byens tilknyttede delstat). Kan være null når byen ikke har noen tilknyttet delstat.
string
Delstatens ISO 3166-2-kode uten landsprefikset (f.eks. BW for Baden-Württemberg). Kan være null.
string
Postnummer. Kan være null.
string
Fullt landnavn (f.eks. Germany). Kan være null.
string
Tobokstavers landkode etter ISO 3166-1 alpha-2 (f.eks. DE, US). Kan være null.
string
IANA-tidssoneidentifikator for stedet (f.eks. Europe/Berlin, America/New_York). Bruk denne for å vise avtalte tidspunkter i riktig lokal tid. Kan være null.
number
Breddegrad for adressen i desimalgrader (WGS 84). Kan være null.
number
Lengdegrad for adressen i desimalgrader (WGS 84). Kan være null.
string
Telefonnummer til stedet. Kan være null.
string
E-postadresse til stedet. Kan være null.
string
Nettadresse til stedet. Kan være null.
string
Direktelenke til stedet på Google Maps. Kan være null.
string
URL til et bilde av stedet. Kan være null.
object
Ukentlige åpningstider for stedet. Hver ukedagsnøkkel (monday–sunday) peker til en array av { open, close }-tidsrom i HH:MM-format (24-timers). En tom array betyr at stedet er stengt den dagen. Kan være null hvis åpningstider ikke er tilgjengelige for stedet.
string
påkrevd
Hvordan blodprøven tas ved en time her med mindre timen angir sin egen draw_method: capillary (fingertupp eller overarm, i mikrorør) eller venous (fra venen, i prøverør).
string[]
påkrevd
Metodene for blodprøvetaking som lokasjonen har prøvebeholdere på lager for, sortert. En time her kan bare angi én av disse som sin draw_method.
Bruk alltid timezone-feltet til å konvertere scheduled_at-tidspunkter til lokal tid før du viser dem til pasienter eller ansatte.

Tilgjengelighet

Feltet open_hours ovenfor beskriver de faste ukentlige åpningstidene. For å vise faktiske ledige tidsluker – og unngå dobbeltbooking mot eksisterende Aniva-timer – kall Get Availability for stedet og send inn datovinduet du vil vise. Det endepunktet er riktig sannhetskilde for ethvert bestillingsgrensesnitt: det utvider open_hours til stedets tidsluker, bruker unntak per dato, trekker fra allerede bestilte timer og tar hensyn til minimumsfrist.

Utsalgspriser

Et apotek setter sin egen pris for hvert panel, og for hver enkelt biomarkør, som det selger til drop-in-kunder. Du ser en pris først når apoteket publiserer den. List Retail Prices returnerer dem for hvert sted du kan lese, og Get Retail Prices returnerer dem for ett sted. Begge krever scopet retail_prices_view; locations_view inkluderer dem ikke. Be om begge scopes på de samme stedene. En location.retail_prices.updated-webhook varsler deg når en pris endres. location.created og location.deactivated varsler deg når et sted kommer til eller forsvinner. En endring i hvilke paneler et sted tilbyr, kan nå deg senere enn en prisendring, så les List Retail Prices på nytt én gang om dagen.

Eksempel på sted