Hoppa till huvudinnehåll
En plats är ett fysiskt provtagningscenter där vårdpersonal utför blodprovstagningar. Du använder platsens id för att schemalägga practitioner-bokningar.
Din API-nyckel returnerar bara platser inom din partners åtkomstkontext. Använd GET /api/v1/locations för att lista alla platser som är tillgängliga för dig.
En location.*-webhook meddelar dig när en plats läggs till, ändras eller tas bort.

Fält

string
obligatorisk
UUID för platsen. Skicka detta som location_id när du skapar en bokning.
string
obligatorisk
Visningsnamn för platsen.
string
Klinik eller företag som driver platsen. Kan vara null.
string
Gatunamn, utan husnummer. Kan vara null.
string
Husnummer. Kan vara null.
string
Extra adressrad – c/o, byggnad eller våning. Kan vara null.
string
Stad. Kan vara null.
string
Delstat eller provins (hämtas via stadens kopplade delstat). Kan vara null när staden saknar en kopplad delstat.
string
Delstatens ISO 3166-2-kod utan landsprefix (t.ex. BW för Baden-Württemberg). Kan vara null.
string
Postnummer. Kan vara null.
string
Fullständigt landsnamn (t.ex. Germany). Kan vara null.
string
Landskod med två bokstäver enligt ISO 3166-1 alpha-2 (t.ex. DE, US). Kan vara null.
string
IANA-tidszonsidentifierare för platsen (t.ex. Europe/Berlin, America/New_York). Använd den för att visa bokade tider i rätt lokal tid. Kan vara null.
number
Adressens latitud i decimalgrader (WGS 84). Kan vara null.
number
Adressens longitud i decimalgrader (WGS 84). Kan vara null.
string
Telefonnummer till platsen. Kan vara null.
string
E-postadress till platsen. Kan vara null.
string
URL till platsens webbplats. Kan vara null.
string
Direktlänk till platsen på Google Maps. Kan vara null.
string
URL till ett foto av platsen. Kan vara null.
object
Veckovisa öppettider för platsen. Varje veckodagsnyckel (monday–sunday) mappas till en array med { open, close }-tidsintervall i formatet HH:MM (24 h). En tom array betyder att platsen är stängd den dagen. Kan vara null om öppettider saknas för platsen.
string
obligatorisk
Hur blodprovet tas vid en bokning här om bokningen inte anger en egen draw_method: capillary (fingertopp eller överarm, i mikrorör) eller venous (från ven, i rör).
string[]
obligatorisk
De provtagningsmetoder som platsen har behållare i lager för, sorterade. En bokning här kan endast ange en av dessa som sin draw_method.
Använd alltid fältet timezone för att konvertera datum och tider i scheduled_at till lokal tid innan du visar dem för patienter eller personal.

Tillgänglighet

Fältet open_hours ovan beskriver det statiska veckoschemat för öppettider. För att visa faktiska bokningsbara tider – och undvika dubbelbokningar mot befintliga Aniva-bokningar – anropar du Hämta tillgänglighet för platsen och skickar med det datumintervall du vill visa. Den endpointen är rätt sanningskälla för alla bokningsgränssnitt: den expanderar open_hours på platsens tidsrutnät, tillämpar undantag per datum, drar bort redan gjorda bokningar och tillämpar minsta framförhållning.

Utpriser

Ett apotek sätter sitt eget pris för varje panel och varje enskild biomarkör som det säljer till drop-in-kunder. Du ser ett pris först när apoteket har publicerat det. Lista utpriser returnerar dem för varje plats du kan läsa, och Hämta utpriser returnerar dem för en plats. Båda kräver scopet retail_prices_view; locations_view inkluderar dem inte. Be om båda scopes för samma platser. En location.retail_prices.updated-webhook meddelar dig när ett pris ändras. location.created och location.deactivated meddelar dig när en plats tillkommer eller försvinner. En ändring av vilka paneler en plats erbjuder kan nå dig senare än en prisändring, så läs Lista utpriser igen en gång om dagen.

Exempelplats