Hopp til hovedinnhold
DELETE
Avbestill en time ved å sette statusen til cancelled. Bare timer der blodprøvetakingen ennå ikke er bekreftet, kan avbestilles. Å avbestille en time som allerede er cancelled, returnerer 200 med den timen og skriver ingenting – ingen ny avbestilling registreres. Svaret inneholder Idempotent-Replayed: true slik at du kan skille en gjentakelse fra kallet som utførte jobben. En gjentakelse med en annen cancellation_reason returnerer i stedet 409: den registrerte årsaken overskrives aldri. Se Idempotens.
Timer kan ikke avbestilles etter at blodprøvetakingen er bekreftet – det returnerer 409 Conflict.
Krever tilgangsomfanget appointments_schedule eller appointments_manage.

Forespørsel

Stiparametere

string
påkrevd
Unik identifikator (UUID) for timen som skal avbestilles.

Body-parametere

Body er valgfri – ikke send noen body i det hele tatt for å avbestille uten å registrere en årsak.
string
Fritekstårsak for avbestillingen, opptil 500 tegn (f.eks. Patient no-show). Lagres på timen og returneres som cancellation_reason ved dette og senere oppslag.

Respons

Når kallet lykkes, returnerer API-et 200 OK med den avbestilte timen og den innebygde profilen.
string
påkrevd
Unik timeidentifikator (UUID).
string
påkrevd
UUID for profilen denne timen tilhører.
string
UUID for teststedet der blodprøvetakingen finner sted.
string
Planlagt tidspunkt for timen i UTC (ISO 8601 med Z-suffiks, f.eks. 2026-05-15T10:30:00Z). Kan være null.
string
påkrevd
Timestatus. Vil være cancelled etter en vellykket avbestilling.
string
Fritekstårsak som ble registrert da timen ble avbestilt (f.eks. manglende oppmøte, sen avbestilling, «Mislyktes. Må gjentas»). null med mindre status er cancelled.
string[]
påkrevd
Adresser som hver får én e-post når alle labresultater er endelige, i små bokstaver. Tom når den er slått av. Se E-poster om klare resultater.
string
påkrevd
Hvordan blodprøven tas: capillary (fingertupp eller overarm, i mikrorør) eller venous (fra vene, i prøverør). Det er metoden som er satt på timen, ellers default_draw_method for stedet. Etter blodprøvetakingen er det metoden som ble brukt.
string
påkrevd
ISO 8601-tidsstempel for når timen ble opprettet.
string
ISO 8601-tidsstempel for siste oppdatering. Kan være null.
object
påkrevd
Pasientprofilen som er knyttet til denne timen.
AppointmentPanel[]
påkrevd
Paneler som var knyttet til denne timen før avbestillingen. Slå opp paneldetaljer (navn, biomarkører) via Vis paneler.
AppointmentIndividualBiomarker[]
påkrevd
Enkeltbiomarkører knyttet til denne timen utenfor et panel (se Legg til egendefinerte biomarkører). Kryssreferer hver biomarker_id mot Vis biomarkører for visningsdata.
AppointmentShipmentLink[]
påkrevd
Forsendelser som var koblet til denne timen før avbestillingen. Hver id kryssrefererer til Hent forsendelse.
string[]
påkrevd
Labkoder (strekkoder på prøverør) som er registrert for denne timen, i skannerekkefølge. Tom til blodprøvetakingen er bekreftet. En venøs blodprøvetaking har én kode trykket på hvert prøverør; en kapillær blodprøvetaking har én kode per mikrorør. Resultater og dokumenter i Hent resultater refererer til disse kodene via lab_code.

Feilresponser