Spring til hovedindhold
Brug denne guide til at finde et teststed, oprette en tid til en patientprofil og tilføje de testpaneler, der skal køres. Gennemfør disse trin, før patienten møder op til sin blodprøvetagning.
1

Gennemse tilgængelige lokationer

Hent listen over teststeder, der er tilgængelige på din konto, ved at sende en GET-anmodning til /api/v1/locations.
Svaret er et array af lokationsobjekter:
Brug feltet timezone fra lokationsobjektet, når du opbygger dit scheduled_at-tidsstempel. Ved at konvertere tidspunktet til lokationens lokale tidszone undgår du at booke uden for åbningstiden.
Udled ikke ledige tider ud fra open_hours alene. Kald Hent ledige tider, og book et starttidspunkt, som den returnerer — den tidsplan tager også højde for eksisterende bookinger, undtagelser for enkelte datoer og mindstevarsel.
2

Opret tiden

Send en POST-anmodning til /api/v1/appointments med profil-ID, lokations-ID og det ønskede tidspunkt. Tidspunktet skal være et starttidspunkt fra Hent ledige tider.
scheduled_at skal være et fremtidigt dato- og tidsstempel i ISO 8601-format, for eksempel 2026-05-12T07:30:00Z. Tidsstempler i fortiden afvises med en 400-fejl, og det samme gælder tider inden for 12-timers mindstevarsel på Aniva-drevne lokationer.
Det er sikkert at gentage denne anmodning. En profil kan kun have én tid pr. lokation og tidspunkt, så en gensendt eller dobbeltindsendt oprettelse returnerer 409 med det eksisterende appointment_id i stedet for at booke patienten to gange.
En vellykket anmodning returnerer 201 Created med tidsobjektet:
Gem tidens id — du skal bruge det til at tilføje paneler og bekræfte blodprøvetagningen.
3

Tilføj testpaneler

Tilknyt de testpaneler, der skal analyseres på blodprøven, ved at sende en POST-anmodning til /api/v1/appointments/{id}/panels.Panel-ID’er er UUID’er. Kald Vis paneler for at få de paneler, din API-nøgle kan bestille.
Paneler kan ikke tilføjes, efter blodprøvetagningen er bekræftet. Tilføj alle nødvendige paneler før bekræftelse — se Bekræft blodprøvetagning for detaljer.
En vellykket anmodning returnerer 200 OK som bekræftelse på, at panelerne er tilføjet:

Ombooking eller aflysning

Når du har oprettet en tid, kan du stadig ændre den, før blodprøvetagningen bekræftes:
  • Ombook eller skift lokation — Send en PATCH-anmodning til /api/v1/appointments/{id} med de felter, der skal opdateres. Se Opdater tid.
  • Aflys — Send en DELETE-anmodning til /api/v1/appointments/{id}. Se Aflys tid.
Begge handlinger er kun tilgængelige før blodprøvetagningen — dvs. mens tiden har statussen pending eller confirmed. Når tiden skifter til blood_drawn, er yderligere ændringer ikke længere mulige.

Fejlhåndtering