Hoppa till huvudinnehåll
När en blodprovstagning har bekräftats och labbet har behandlat proverna blir resultaten tillgängliga på bokningen. Resultaten hämtas via GET /api/v1/appointments/{id}/results och innehåller kliniska biomarkörresultat, genetiska biomarkörresultat och nedladdningsbara labbrapporter.

Resultatstatus

Fältet status på toppnivå i resultatsvaret visar hur långt behandlingen har kommit: Enskilda resultat i svaret har sin egen status per resultat (se nedan), så du kan visa delresultat medan den övergripande statusen fortfarande är in_progress. Prenumerera på webhooks för att få veta när resultat ändras. appointment.results.updated utlöses vid varje ändring av resultatinnehållet, och appointment.results.completed utlöses när statusen på toppnivå ändras till completed. Beställningar av hemtestkit skickar samma händelser med prefixet home_kit_order.. Varje händelse innehåller resultat-URL:en som ska hämtas. Du kan fortfarande polla den här slutpunkten för att stämma av. Arrayen submissions delar upp statusen på toppnivå per laboratorieremiss. En blodprovstagning som omfattar flera rör eller flera laboratorier har flera poster, var och en med den lab_code (rörets streckkod) den registrerades under och en egen status (in_progress / completed / fault). En post med fault avvisades eller avbröts på labbet och kommer aldrig att rapportera: provet flyttades ofta till ett annat laboratorium, som då registrerar en egen post. Statusen på toppnivå är completed när alla poster har avslutats och minst en har rapporterat. Varje mottaget resultat och varje dokument har samma lab_code, så du kan se vilket rör ett värde kommer ifrån.

Kliniska resultat

Kliniska resultat är vanliga mätningar av biomarkörer i blodet — till exempel D-vitaminnivåer, kolesterol, sköldkörtelhormoner och liknande. Varje kliniskt resultat innehåller:
  • id — identifieraren för labbresultatraden. Den förblir densamma när labbet korrigerar raden, så använd den för upsert. null för ett planned-resultat.
  • biomarker_name och category — vad som mättes och dess gruppering (t.ex. vitaminer, hormoner).
  • lab_code — labbkoden (rörets streckkod) som resultatet registrerades under, en av beställningens labbkoder. null för ett planned-resultat och för resultat som labbet rapporterade utan kod.
  • value och value_operator — det faktiska mätvärdet. Operatorn är eq (lika med) för exakta värden, eller lt/gt när labbet rapporterar ett värde under eller över det mätbara intervallet.
  • unit — måttenheten (t.ex. ng/mL, µIU/mL).
  • reference_range_lab — normala och optimala min-/maxgränser som labbet rapporterat för det här resultatet, omvandlade till samma skala som value. En gräns som labbet lämnar öppen är null, så ett ensidigt intervall som < 50 kommer som normal_min: null, normal_max: 50. Varje resultat innehåller det intervall som det mättes mot, så en patient med resultat från flera blodprovstagningar eller labb får rätt intervall per resultat.
  • reference_range_lab_absent_reason — varför reference_range_lab är null. null när intervallet finns och på ett planned-resultat. Se När det saknas labbintervall.
  • aniva_range — Jämförelsevärden som Aniva har sammanställt, på samma skala som value. De varierar efter ålder, kön och graviditetsvecka. normal_* är det allmänna intervallet. optimal_* är ett snävare intervall. Värdena är endast information. De är inte medicinsk rådgivning, inte en diagnos och inte en bedömning av resultatet. Aniva sätter ingen flagga mot dem. Använd reference_range_lab som standard för resultatet. null när din nyckel inte har scopet aniva_ranges_view, eller när Aniva saknar värden för den här biomarkören.
  • tested_at — datumet då testet utfördes.
  • comment — fritextanteckning från labbet för just det här resultatet (t.ex. vägledning om referensintervall, varningar om provkvalitet). null när labbet inte bifogat någon.
  • status_reason — varför ett likely_wrong-resultat är tveksamt, eller varför ett fault- eller undeliverable-resultat är oanvändbart. null för alla andra statusar. Skiljer sig från comment, som är labbets egen anteckning och ofta är tom på felaktiga resultat.
  • origin — vem som levererade dokumentet värdet kommer från, med samma värden som dokumentets origin nedan. Ett värde från ett uppladdat dokument (member_upload, staff_upload, partner_upload) kommer från att Aniva läst av filen, inte från en labbrapport: kontrollera det mot filen före klinisk användning. null för ett planned-resultat.
  • lab_reported — det utförande labbets egen rapportrad, ordagrant och utan omvandling. Se nedan.

Aniva-intervall

aniva_range innehåller jämförelsevärden som Aniva har sammanställt från publicerade källor och eget urval. Intervallen varierar efter ålder, kön och graviditetsvecka. sources listar de publicerade källor som Aniva har registrerat för värdena. Listan kan vara tom.
Värdena är allmän information. De är inte medicinsk rådgivning, inte en diagnos, inte ett medicinskt fynd och inte en bedömning av ett resultat. Aniva tillhandahåller dem inte som en medicinteknisk produkt. Aniva jämför inte ett resultat med dem och sätter ingen flagga mot dem. reference_range_lab och bedömningen av en läkare förblir standard för ett resultat.
Regler för din produkt:
  • Visa bara Aniva-intervallet som ett tillägg till laboratoriets intervall, aldrig i stället för det.
  • Om du härleder en flagga, en varning eller en rekommendation från Aniva-intervallet gör du det i eget namn och på eget ansvar.
  • Visa upplysningen från ditt avtal med Aniva överallt där du visar Aniva-intervallet.
För att få åtkomst signerar du det korta avtalet om Aniva-intervall. Därefter lägger vi till scopet aniva_ranges_view på din nyckel. Värdena kan ändras utan förvarning.

Normaliserade värden jämfört med labbets egen rad

value, unit och reference_range_lab är normaliserade: vi omvandlar varje mätning till biomarkörens standardenhet och rapporterar den under vårt eget biomarkörnamn, så att samma analyt går att jämföra mellan labb och över tid. Det är vad du vill ha för trender och jämförelser mellan labb, och det är inte vad en granskande läkare ser på labbets PDF — alkaliskt fosfatas som står som 48 U/l (40 - 129) når dig som 0.8 µkat/L. lab_reported innehåller den utskrivna raden vid sidan av: labbets analytnamn och kod, värdet och enheten som de skrevs ut, referensintervallet både som text (< 50, > 55, 40 - 129) och som labbets egna oomvandlade gränser, plus dess avvikelseflagga, resultatstatus och anteckning. Använd lab_reported när en människa stämmer av dina data mot labbets rapport, och standardfälten för allt som beräknas. Endast fält som labbet faktiskt skickade fylls i; inget i lab_reported härleds, ges standardvärden eller omvandlas, och hela objektet är null när vi saknar rådata för ett resultat.

När det saknas labbintervall

När reference_range_lab är null visar reference_range_lab_absent_reason varför: Vissa labb anger ett målvärde eller en risknivå i stället för ett referensintervall, till exempel Ziel: <200. >240 hoch eller <5.7 neg >=6.5 pos. Dessa hamnar inte i reference_range_lab, så dess gränser är null och orsaken är lab_text_only. Visa den angivna texten ordagrant. Ett ensidigt intervall som < 20 är ett intervall. Det kommer i reference_range_lab med ena gränsen som null, och orsaken är null. Behåll den öppna sidan öppen när du visar det.

Statusar för kliniska resultat

När du visar resultat för patienter använder du fältet value direkt — det visar redan det korrigerade värdet om det finns ett.
Visa aldrig ett fault-resultat som ett fynd — dess value är ifyllt men bekräftat felaktigt.

Genetiska resultat

Genetiska resultat är fynd på gennivå från DNA-analys. Varje resultat motsvarar en gen (t.ex. APOE, MTHFR) och innehåller:
  • id — identifieraren för labbresultatraden. Den förblir densamma när labbet korrigerar raden, så använd den för upsert. null för ett planned-resultat.
  • gene — gensymbolen.
  • lab_code — labbkoden (rörets streckkod) som resultatet registrerades under. null för ett planned-resultat och för resultat som labbet rapporterade utan kod.
  • genotype — den upptäckta genotypen (t.ex. E3/E4).
  • clinical_significance — en ACMG-baserad klassificering av fyndet.
  • risk_description — en läsbar förklaring av vad genotypen innebär.
  • comment — fritextanteckning från labbet för just det här resultatet. null när labbet inte bifogat någon.
  • status_reason — varför ett likely_wrong-resultat är tveksamt, eller varför ett fault- eller undeliverable-resultat är oanvändbart. null för alla andra statusar.
  • origin — vem som levererade dokumentet värdet kommer från, på samma sätt som för kliniska resultat.
  • variants — de specifika genetiska varianter som upptäckts, var och en med detaljer på SNV-nivå.

Värden för klinisk signifikans

Statusar för genetiska resultat

Variantstruktur

Varje genetiskt resultat innehåller en variants-array. Varje variant inkluderar:
  • name — vanligt namn (t.ex. APOE E4).
  • clinical_significance — betydelse på variantnivå (kan skilja sig från betydelsen på gennivå).
  • conditions — associerade sjukdomar/tillstånd med beskrivningar.
  • snvs — de underliggande enkelnukleotidvarianterna, var och en med rs_id, allele, reference_allele och valfri HGVS-notation.

Dokument

Arrayen documents i resultatsvaret innehåller referenser till nedladdningsbara filer med labbrapporter. Varje dokument har:
  • id — filens UUID. Skicka detta till GET /api/v1/documents/{id} för att ladda ner filen.
  • file_name — filnamnet, samma som skickas vid nedladdning (t.ex. 20260405 - Quade Befund - 7642001234.pdf).
  • original_file_name — filnamnet exakt som laboratoriet eller uppladdaren levererade det (t.ex. 7642001234_B0012_FA_E.pdf).
  • origin — vem som levererade filen: lab, member_upload, staff_upload eller partner_upload (du laddade upp den med Ladda upp dokument).
  • content_type — filens mediatyp (t.ex. application/pdf). De flesta rapporter är PDF-filer. Uppladdade skanningar kan vara bilder eller CSV-filer.
  • etag — versionen av filinnehållet; den ändras varje gång filens byte ändras. Spara den och ladda bara ner igen när den ändras. Det är den vanliga HTTP-entitetstaggen, som används av S3 eller Google Cloud Storage.
  • size_bytes — filstorleken i byte.
  • lab_code — labbkoden (provrörets streckkod) som rapporten tillhör; null när laboratoriet inte angett någon.
Åtkomst till dokument valideras mot den profil som äger dokumentet.

Mejla resultat till kunden

Du kan meddela kunden via mejl att resultaten är klara. Anropa Mejla resultat för en bokning, eller Mejla resultat för en beställning av hemtestkit. Varje anrop skickar ett mejl. Anrop dedupliceras inte.
  • Mejlet skickas till profilens email. En platshållaradress med @aniva.email avvisas.
  • Mejlet visar namnet och logotypen för profilens primära profilgrupp.
  • Mejlet är på profilens language, engelska som standard.
  • Sätt with_reports till true för att bifoga labbrapporterna.
  • Lägg till note för att visa ett personligt meddelande i mejlet, högst 1 000 tecken.
Om profilen har stängt av transaktionsmejl returnerar anropet 409 med orsaken unsubscribed. För att slå på dem igen, sätt transactional_emails_enabled till true med Uppdatera profil.

Mejl när resultat är klara

Du kan få ett mejl när resultaten för en bokning är klara. Sätt results_ready_emails till upp till 5 adresser i Skapa bokning eller Skapa beställning av hemtestkit. Ändra listan senare med Uppdatera bokning eller Uppdatera beställning av hemtestkit; [] stänger av mejlen.
  • Be oss ställa in standardmejladresser för din profilgrupp. En bokning som skapas utan results_ready_emails får dem. En lista ersätter dem för den bokningen, så inkludera din standardmejladress för att behålla den. [] skickar inget mejl.
  • Varje adress får ett mejl så snart alla labbresultat för bokningen är slutgiltiga.
  • En adress som läggs till efter att resultaten är slutgiltiga får mejlet direkt.
  • Mejlet länkar till resultatsidan i Anivas adminpanel. Kunden får inte mejlet.
  • Din nyckel behöver results_view-åtkomst till patienten. Utan den returnerar förfrågan 403.

Visa resultat i din app

Skapa inbäddningssession returnerar en engångs-URL till en skrivskyddad resultatsida. Öppna den i en WebView i din app så att patienten ser resultaten utan att logga in.
  • Din nyckel behöver embed- och results_view-scopes för patienten. Be Aniva om embed-scopet.
  • Anropa den från din server varje gång patienten öppnar resultaten. URL:en fungerar en gång och i 5 minuter, och sidan håller sedan en 60-minuterssession.
  • route öppnar en av sidorna vi släpper: biomarkörlistan, en biomarkör eller 3D Twin.
  • appearance styr temat, färgen på knappar och länkar samt om din logotyp visas.
  • report begränsar sidan till en bokning, en beställning av hemtestkit eller en labbrapport som du laddat upp med POST /api/v1/documents. Patienten ser då bara resultaten från den rapporten.
  • Sidan visar bara labbresultat, precis som det här API:et. Den visar inga filer, ingen chatt och inga inställningar.

Exempel på resultatsvar