Spring til hovedindhold
DELETE
Aflys en tid ved at sætte dens status til cancelled. Kun tider, hvor blodprøvetagningen endnu ikke er bekræftet, kan aflyses. At aflyse en tid, der allerede er cancelled, returnerer 200 med den tid og skriver intet — der registreres ingen ny aflysning. Svaret har Idempotent-Replayed: true, så du kan skelne en gentagelse fra det kald, der udførte arbejdet. En gentagelse med en anden cancellation_reason returnerer i stedet 409: den registrerede årsag bliver aldrig overskrevet. Se Idempotens.
Tider kan ikke aflyses, når blodprøvetagningen er bekræftet — det returnerer 409 Conflict.
Kræver scope appointments_schedule eller appointments_manage.

Forespørgsel

Stiparametre

string
påkrævet
Unikt id (UUID) for den tid, der skal aflyses.

Body-parametre

Body er valgfri — send slet ingen body for at aflyse uden at registrere en årsag.
string
Fritekstårsag til aflysningen på op til 500 tegn (f.eks. Patient no-show). Gemmes på tiden og returneres som cancellation_reason i dette og senere opslag.

Svar

Ved succes returnerer API’et 200 OK med den aflyste tid og dens indlejrede profil.
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
Tidens status. Vil være cancelled efter en gennemført aflysning.
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.
string
påkrævet
ISO 8601-tidsstempel for, hvornår tiden blev oprettet.
string
ISO 8601-tidsstempel for den seneste opdatering. Kan være null.
object
påkrævet
Den patientprofil, der er knyttet til denne tid.
AppointmentPanel[]
påkrævet
Paneler, der var knyttet til denne tid før aflysningen. Slå paneldetaljer (navn, biomarkører) op via Vis paneler.
AppointmentIndividualBiomarker[]
påkrævet
À la carte-biomarkører knyttet til denne tid uden for et panel (se Tilføj valgfrie biomarkører). Krydsreferer hvert biomarker_id med Vis biomarkører for visningsdata.
AppointmentShipmentLink[]
påkrævet
Forsendelser, der var knyttet til denne tid før aflysningen. Hvert id krydsrefererer til Hent 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.

Fejlsvar