Spring til hovedindhold
POST
Book en tid til blodprøvetagning for en patientprofil på en bestemt testlokation. Når tiden er oprettet, får den som standard statussen confirmed (nogle lokationer kan i stedet bruge pending som standard — dette indstilles pr. lokation). Brug Tilføj paneler til at tilknytte blodprøvepaneler, før du bekræfter blodprøvetagningen.
En profil kan højst have én tid pr. lokation og tidspunkt. Opretter du en tid i et tidsrum, som profilen allerede har booket, returneres 409 med det eksisterende appointment_id i stedet for endnu en tid — så et nyt forsøg eller en utilsigtet gentaget anmodning aldrig kan oprette en dobbeltbooking. Se Dublerede tider.
Send en valgfri Idempotency-Key-header for at gøre denne oprettelse sikker at prøve igen — gentages den samme nøgle, returneres det oprindelige svar i stedet for at oprette endnu en. Se Idempotens. Kræver scopet appointments_schedule.

Forespørgsel

Body-parametre

string
påkrævet
UUID på den patientprofil, tiden skal oprettes for.
string
påkrævet
UUID på den testlokation, hvor blodprøvetagningen skal finde sted. Brug Vis lokationer for at finde tilgængelige lokations-ID’er.
string
påkrævet
Dato og tidspunkt for tiden i ISO 8601-format (f.eks. 2026-05-15T10:30:00Z eller 2026-05-15T12:30:00+02:00). Skal indeholde en tidszoneangivelse — enten Z eller en eksplicit forskydning som +02:00; tidspunkter uden tidszone afvises. Skal ligge i fremtiden.Skal være et præcist starttidspunkt i lokationens tidsplan, og tidsrummet skal stadig have kapacitet — læs Hent tilgængelighed først. Tidspunkter uden for tidsplanen returnerer 400; et tidsrum, der er fyldt op, returnerer 409. På Aniva-drevne lokationer skal det også ligge mindst 12 timer fremme — se Minimumsvarsel.
string[]
Op til 5 adresser, der hver får én e-mail, når alle laboratorieresultater er endelige. E-mailen linker til resultatsiden i Anivas adminpanel. Din nøgle skal have results_view-adgang til patienten, ellers 403. Udelad feltet for at bruge de standardadresser, der er angivet for patientens gruppe. En tom liste slår e-mails fra. Se E-mails om færdige resultater.
string
Hvordan blodprøven tages: capillary eller venous. Udelad feltet for at bruge lokationens default_draw_method. Lokationen skal have metoden på listen draw_methods, ellers 400.

Svar

Ved succes returnerer API’et 201 Created med den nye tid.
string
påkrævet
Unikt id for tiden (UUID).
string
påkrævet
UUID for den profil, denne tid tilhører.
string
UUID for det teststed, hvor blodprøvetagningen finder sted.
string
Planlagt dato og tidspunkt for tiden i UTC (ISO 8601 med Z-suffiks, f.eks. 2026-05-15T10:30:00Z). Kan være null.
string
påkrævet
Aktuel status for tiden. En af pending, confirmed, blood_drawn eller cancelled. Fremdriften i laboratorieresultaterne udledes fra Hent resultater; mere detaljeret forsendelsesfremdrift fra hvert element i det indlejrede shipments-array (se nedenfor) videre til Hent forsendelse.
string
Fritekstårsag registreret ved aflysning af tiden (f.eks. udeblivelse, sen aflysning, ‘Failed. Repeat required’). null, medmindre status er cancelled.
string[]
påkrævet
Adresser med små bogstaver, som hver modtager én e-mail, når alle laboratorieresultater er endelige. Tom, når funktionen er slået fra. Se E-mails når resultater er klar.
string
påkrævet
Hvordan blodet tages: capillary (fingerspids eller overarm i mikrorør) eller venous (fra venen i prøveglas). Det er den metode, tiden angiver, ellers default_draw_method for dens lokation. Efter blodprøvetagningen er det den metode, der blev brugt.
object
påkrævet
Den patientprofil, der er knyttet til denne tid.
AppointmentPanel[]
påkrævet
Paneler, der aktuelt er tilknyttet denne tid. Tom for nyoprettede tider — tilknyt via Tilføj paneler. Slå paneldetaljer (navn, biomarkører) op via Vis paneler.
AppointmentIndividualBiomarker[]
påkrævet
À la carte-biomarkører tilknyttet denne tid uden for et panel. Tom for nyoprettede tider — tilknyt via Tilføj individuelle biomarkører. Slå hvert biomarker_id op i Vis biomarkører for visningsdata.
AppointmentShipmentLink[]
påkrævet
Forsendelser tilknyttet denne tid, med ældste tilknytning først. Tom for nyoprettede tider — tilknyt via Opret forsendelse (med appointment_id) eller Tilknyt tider til forsendelse.
string[]
påkrævet
Laboratoriekoder (stregkoder på prøveglas) registreret for denne tid i scanningsrækkefølge. Tom, indtil blodprøvetagningen er bekræftet. En venøs blodprøvetagning har én kode trykt på hvert prøveglas; en kapillær blodprøvetagning har én kode pr. mikrorør. Resultater og dokumenter i Hent resultater henviser til disse koder via lab_code.

Minimumsvarsel

Tider på Aniva-drevne lokationer skal bookes mindst 12 timer i forvejen; booking inden for det tidsrum returnerer 400. Hent tilgængelighed udelader allerede disse tidsrum, så alt, du læser fra den tidsplan, kan bookes. Lokationer, du selv driver, har intet minimumsvarsel — booking samme dag og walk-in er uændret.

Dublerede tider

En profil kan højst have én ikke-aflyst tid pr. lokation og tidspunkt — én person kan ikke få taget blodprøve to gange samme sted på samme tidspunkt, uanset hvor mange stole lokationen har. Opretter du en tid i et tidsrum, som profilen allerede har booket, returneres 409 med et appointment_id, der angiver den tid, der allerede findes:
Håndter det ved at betragte anmodningen som allerede gennemført: hent tiden med Hent tid, flyt den med Opdater tid, eller aflys den med Aflys tid. Prøv ikke at oprette igen — det bliver ved med at returnere 409. Det gør gentagne oprettelser sikre: en anmodning, du sender igen efter en timeout, eller en formular indsendt to gange, kan ikke oprette to tider til den samme patient på det samme tidspunkt.
appointment_id er kun med på dublet-409. Kapacitets-409 — når tidsrummet er fyldt, fordi andre patienter har booket det — returnerer kun error, og den rette løsning her er at vælge et andet tidsrum fra Hent tilgængelighed.

Fejlsvar