GET /api/v1/appointments/{id}/results och innehåller kliniska biomarkörresultat, genetiska biomarkörresultat och nedladdningsbara labbrapporter.
Resultatstatus
Fältetstatus 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.nullför ettplanned-resultat.biomarker_nameochcategory— 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.nullför ettplanned-resultat och för resultat som labbet rapporterade utan kod.valueochvalue_operator— det faktiska mätvärdet. Operatorn äreq(lika med) för exakta värden, ellerlt/gtnä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 somvalue. En gräns som labbet lämnar öppen ärnull, så ett ensidigt intervall som< 50kommer somnormal_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örreference_range_labärnull.nullnär intervallet finns och på ettplanned-resultat. Se När det saknas labbintervall.aniva_range— Jämförelsevärden som Aniva har sammanställt, på samma skala somvalue. 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ändreference_range_labsom standard för resultatet.nullnär din nyckel inte har scopetaniva_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).nullnär labbet inte bifogat någon.status_reason— varför ettlikely_wrong-resultat är tveksamt, eller varför ettfault- ellerundeliverable-resultat är oanvändbart.nullför alla andra statusar. Skiljer sig fråncomment, 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 dokumentetsoriginnedan. 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.nullför ettplanned-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.
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.
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ärreference_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
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.nullför ettplanned-resultat.gene— gensymbolen.lab_code— labbkoden (rörets streckkod) som resultatet registrerades under.nullför ettplanned-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.nullnär labbet inte bifogat någon.status_reason— varför ettlikely_wrong-resultat är tveksamt, eller varför ettfault- ellerundeliverable-resultat är oanvändbart.nullfö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 envariants-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 medrs_id,allele,reference_alleleoch valfri HGVS-notation.
Dokument
Arrayendocuments i resultatsvaret innehåller referenser till nedladdningsbara filer med labbrapporter. Varje dokument har:
id— filens UUID. Skicka detta tillGET /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_uploadellerpartner_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;nullnä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.emailavvisas. - Mejlet visar namnet och logotypen för profilens primära profilgrupp.
- Mejlet är på profilens
language, engelska som standard. - Sätt
with_reportstilltrueför att bifoga labbrapporterna. - Lägg till
noteför att visa ett personligt meddelande i mejlet, högst 1 000 tecken.
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ättresults_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_emailsfå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ågan403.
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- ochresults_view-scopes för patienten. Be Aniva omembed-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.appearancestyr temat, färgen på knappar och länkar samt om din logotyp visas.reportbegränsar sidan till en bokning, en beställning av hemtestkit eller en labbrapport som du laddat upp medPOST /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.