Hoppa till huvudinnehåll
GET
Hämta kliniska och genetiska labbresultat för en bokning, tillsammans med dokumentreferenser för labbrapporter i PDF-format. Varje biomarkör som beställts för bokningen visas i svaret, så att du kan följa hela beställningen i stället för bara det som kommit tillbaka. Läs status på varje resultat innan du använder dess value:
  • Tester som ännu inte är klara visas med statusen planned medan bokningen har statusen in_progress.
  • Resultat som laboratoriet levererat men som inte får användas kliniskt visas med statusen fault eller undeliverable och har en status_reason som förklarar varför. Ett resultat med fault har fortfarande sitt value ifyllt — det värdet är fel. Presentera det aldrig som ett fynd.
  • Resultat som Aniva eller medlemmen tvivlar på visas med statusen likely_wrong och en status_reason. Värdet är inte bekräftat. Visa det inte som ett fynd utan granskning.
Varje mottaget resultat och dokument har den lab_code (rörets streckkod) som det registrerats under, och arrayen submissions listar varje laboratorieremiss från blodprovstagningen med egen status — en blodprovstagning som omfattar flera rör eller laboratorier slutförs remiss för remiss. Använd Ladda ner dokument för att ladda ner PDF-filer med labbrapporter som refereras i arrayen documents. Du behöver inte polla den här endpointen. Prenumerera på webhooks för appointment.results.updated eller appointment.results.completed och anropa den när en händelse kommer in. Polling fungerar fortfarande som reservlösning. Kräver scopet results_view.

Förfrågan

Sökvägsparametrar

string
obligatorisk
Unik identifierare (UUID) för bokningen som resultat ska hämtas för.

Svar

Vid framgång returnerar API:et 200 OK med resultatobjektet.
string
obligatorisk
Övergripande status för resultaten. Ett av följande:
  • in_progress — vissa remisser är fortfarande hos laboratoriet.
  • completed — varje remiss har avslutats och minst en har rapporterat.
  • fault — varje remiss avbröts utan att rapportera. Inget återstår.
object[]
obligatorisk
En post per laboratorieremiss — en blodprovstagning som omfattar flera rör eller laboratorier har flera. status på toppnivå är completed när varje post har avslutats och en har rapporterat.
object[]
obligatorisk
Array med kliniska biomarkörresultat.
object[]
obligatorisk
Array med genetiska biomarkörresultat.
object[]
obligatorisk
Dokument med labbrapporter. Använd GET /api/v1/documents/{id} för att ladda ner varje fil.

Upprepade anrop

Aniva lagrar svaret från den här slutpunkten i 60 minuter per API-nyckel. Ett upprepat anrop inom den tiden får det lagrade svaret så länge bokningen och dess resultat är oförändrade. Efter en ändring får du ett nytt svar. Headerna Cache-Status och Age visar att svaret är lagrat och hur gammalt det är. För att få veta om en ändring direkt, prenumerera på webhook-händelserna appointment.results.updated, appointment.results.completed och appointment.results.fault. Se Upprepade läsningar.

Felsvar