Spring til hovedindhold
GET
Hent kliniske og genetiske laboratorieresultater for en tid samt dokumentreferencer til PDF-laboratorierapporter. Hver biomarkør, der er bestilt til tiden, vises i svaret, så du kan følge hele bestillingen og ikke kun det, der er kommet tilbage. Læs status på hvert resultat, før du bruger dets value:
  • Prøver, der stadig afventer svar, vises med status planned, mens tiden er in_progress.
  • Resultater, som laboratoriet har leveret, men som ikke må bruges klinisk, vises med status fault eller undeliverable og har en status_reason, der forklarer hvorfor. Et fault-resultat har stadig sin value udfyldt — den værdi er forkert. Vis den aldrig som et fund.
  • Resultater, som Aniva eller medlemmet er i tvivl om, vises med status likely_wrong og en status_reason. Værdien er ikke bekræftet. Vis den ikke som et fund uden gennemgang.
Hvert modtaget resultat og dokument har den lab_code (stregkode på prøveglasset), det blev registreret under, og arrayet submissions viser hver laboratorierekvisition for blodprøvetagningen med sin egen status — en blodprøvetagning fordelt på flere prøveglas eller laboratorier afsluttes rekvisition for rekvisition. Brug Download dokument til at downloade PDF-laboratorierapporter, der henvises til i arrayet documents. Du behøver ikke at polle dette endpoint. Abonnér på webhooks for appointment.results.updated eller appointment.results.completed, og kald det, når der kommer en hændelse. Polling fungerer stadig som fallback. Kræver scopet results_view.

Forespørgsel

Stiparametre

string
påkrævet
Unikt ID (UUID) for den tid, der skal hentes resultater for.

Svar

Ved succes returnerer API’et 200 OK med resultatobjektet.
string
påkrævet
Samlet status for resultaterne. En af følgende:
  • in_progress — nogle rekvisitioner er stadig hos laboratoriet.
  • completed — alle rekvisitioner er afsluttet, og mindst én har rapporteret.
  • fault — alle rekvisitioner fejlede uden at rapportere. Der udestår intet.
object[]
påkrævet
Én post pr. laboratorierekvisition — en blodprøvetagning fordelt på flere prøveglas eller laboratorier har flere. Den overordnede status er completed, når alle poster er afsluttet, og én har rapporteret.
object[]
påkrævet
Array af kliniske biomarkørresultater.
object[]
påkrævet
Array af genetiske biomarkørresultater.
object[]
påkrævet
Dokumenter med laboratorierapporter. Brug GET /api/v1/documents/{id} til at downloade hver fil.

Gentagne kald

Aniva gemmer svaret fra dette endpoint i 60 minutter for hver API-nøgle. Et gentaget kald inden for dette tidsrum får det gemte svar, så længe tiden og dens resultater er uændrede. Efter en ændring får du et nyt svar. Headerne Cache-Status og Age viser, at svaret er gemt, og hvor gammelt det er. Hvis du vil have besked om en ændring med det samme, kan du abonnere på webhook-hændelserne appointment.results.updated, appointment.results.completed og appointment.results.fault. Se Gentagne læsninger.

Fejlsvar