Spring til hovedindhold
En lokation er et fysisk testcenter, hvor sundhedspersonale udfører blodprøvetagninger. Du bruger en lokations id til at booke practitioner-tider.
Din API-nøgle returnerer kun lokationer inden for din partneradgangskontekst. Brug GET /api/v1/locations til at hente alle lokationer, der er tilgængelige for dig.
En location.*-webhook giver dig besked, når en lokation oprettes, ændres eller fjernes.

Felter

string
påkrævet
UUID for lokationen. Send dette som location_id, når du opretter en tid.
string
påkrævet
Visningsnavn for lokationen.
string
Klinik eller virksomhed, der driver lokationen. Kan være null.
string
Vejnavn uden husnummer. Kan være null.
string
Husnummer. Kan være null.
string
Ekstra adresselinje — c/o, bygning eller etage. Kan være null.
string
By. Kan være null.
string
Delstat eller region (afledt fra byens tilknyttede delstat). Kan være null, når byen ikke har en tilknyttet delstat.
string
Delstatens ISO 3166-2-kode uden landepræfiks (f.eks. BW for Baden-Württemberg). Kan være null.
string
Postnummer eller ZIP-kode. Kan være null.
string
Fuldt landenavn (f.eks. Germany). Kan være null.
string
Landekode på to bogstaver efter ISO 3166-1 alpha-2 (f.eks. DE, US). Kan være null.
string
IANA-tidszone-id for lokationen (f.eks. Europe/Berlin, America/New_York). Brug det til at vise planlagte tidspunkter i den korrekte lokale tid. Kan være null.
number
Adressens breddegrad i decimalgrader (WGS 84). Kan være null.
number
Adressens længdegrad i decimalgrader (WGS 84). Kan være null.
string
Telefonnummer til lokationen. Kan være null.
string
E-mailadresse til lokationen. Kan være null.
string
URL til lokationens hjemmeside. Kan være null.
string
Direkte link til lokationen på Google Maps. Kan være null.
string
URL til et foto af lokationen. Kan være null.
object
Ugentlige åbningstider for lokationen. Hver ugedagsnøgle (monday–sunday) peger på et array af { open, close }-tidsrum i HH:MM-format (24 timer). Et tomt array betyder, at lokationen holder lukket den dag. Kan være null, hvis der ikke findes åbningstider for lokationen.
string
påkrævet
Hvordan blodprøven tages ved en tid her, medmindre tiden angiver sin egen draw_method: capillary (fingerspids eller overarm, i mikrorør) eller venous (fra venen, i prøverør).
string[]
påkrævet
De prøvetagningsmetoder, lokationen har beholdere på lager til, sorteret. En tid her kan kun angive en af disse som sin draw_method.
Brug altid feltet timezone til at konvertere scheduled_at-tidspunkter til lokal tid, før du viser dem til patienter eller personale.

Ledige tider

Feltet open_hours ovenfor beskriver de faste ugentlige åbningstider. For at vise reelle ledige tider — og undgå dobbeltbookinger med eksisterende Aniva-tider — kalder du Hent ledige tider for lokationen og sender det datointerval med, du vil vise. Det endpoint er den rette datakilde til enhver booking-UI: Det omsætter open_hours til lokationens tidsintervaller, tager højde for undtagelser pr. dato, trækker allerede bookede tider fra og anvender minimumsvarsel.

Udsalgspriser

Et apotek fastsætter selv sin pris for hvert panel og for hver enkelt biomarkør, det sælger til walk-in-kunder. Du ser først en pris, når apoteket har offentliggjort den. Vis udsalgspriser returnerer dem for alle lokationer, du kan læse, og Hent udsalgspriser returnerer dem for én lokation. Begge kræver scopet retail_prices_view; locations_view inkluderer dem ikke. Bed om begge scopes for de samme lokationer. En location.retail_prices.updated-webhook giver dig besked, når en pris ændres. location.created og location.deactivated giver besked, når en lokation kommer til eller forsvinder. En ændring i, hvilke paneler en lokation tilbyder, kan nå frem senere end en prisændring, så kald Vis udsalgspriser igen én gang om dagen.

Eksempel på lokation