Hopp til hovedinnhold
GET
Hent kliniske og genetiske laboratorieresultater for en time, sammen med dokumentreferanser for PDF-er med laboratorierapporter. Hver biomarkør som er bestilt for timen, vises i svaret, slik at du kan følge hele bestillingen og ikke bare det som har kommet tilbake. Les status på hvert resultat før du bruker value:
  • Prøver som fortsatt gjenstår, vises med status planned mens timen er in_progress.
  • Resultater som laboratoriet har levert, men som ikke må brukes klinisk, vises med status fault eller undeliverable, og har en status_reason som forklarer hvorfor. Et fault-resultat har fortsatt value fylt ut – den verdien er feil. Presenter den aldri som et funn.
  • Resultater som Aniva eller medlemmet er i tvil om, vises med status likely_wrong og en status_reason. Verdien er ikke bekreftet. Ikke vis den som et funn uten gjennomgang.
Hvert mottatt resultat og dokument har lab_code (strekkode på prøverøret) som det ble registrert under, og submissions-arrayet lister opp hver laboratorierekvisisjon fra blodprøvetakingen med egen status – en blodprøvetaking fordelt på flere prøverør eller laboratorier fullføres rekvisisjon for rekvisisjon. Bruk Last ned dokument for å laste ned PDF-er med laboratorierapporter som det vises til i documents-arrayet. Du trenger ikke polle dette endepunktet. Abonner på webhooks for appointment.results.updated eller appointment.results.completed, og kall endepunktet når en hendelse kommer inn. Polling fungerer fortsatt som reserveløsning. Krever scopet results_view.

Forespørsel

Stiparametere

string
påkrevd
Unik identifikator (UUID) for timen det skal hentes resultater for.

Respons

Ved suksess returnerer API-et 200 OK med resultatobjektet.
string
påkrevd
Samlet status for resultatene. En av:
  • in_progress – noen rekvisisjoner er fortsatt hos laboratoriet.
  • completed – alle rekvisisjoner er avsluttet og minst én har rapportert.
  • fault – alle rekvisisjoner feilet uten å rapportere. Ingenting utestår.
object[]
påkrevd
Én oppføring per laboratorierekvisisjon – en blodprøvetaking fordelt på flere prøverør eller laboratorier har flere. Toppnivåets status er completed når alle oppføringer er avsluttet og én har rapportert.
object[]
påkrevd
Liste med kliniske biomarkørresultater.
object[]
påkrevd
Liste med genetiske biomarkørresultater.
object[]
påkrevd
Labrapportdokumenter. Bruk GET /api/v1/documents/{id} for å laste ned hver fil.

Gjentatte kall

Aniva lagrer svaret fra dette endepunktet i 60 minutter for hver API-nøkkel. Et gjentatt kall innenfor denne tiden får det lagrede svaret så lenge timen og resultatene er uendret. Etter en endring får du et nytt svar. Headerne Cache-Status og Age viser at svaret er lagret og hvor gammelt det er. For å få beskjed om en endring med en gang, abonner på webhook-hendelsene appointment.results.updated, appointment.results.completed og appointment.results.fault. Se Gjentatte lesinger.

Feilresponser