Hopp til hovedinnhold
Etter at en blodprøvetaking er bekreftet og laboratoriet har behandlet prøvene, blir resultater tilgjengelige på timen. Resultater hentes via GET /api/v1/appointments/{id}/results og inkluderer kliniske biomarkørresultater, genetiske biomarkørresultater og nedlastbare laboratorierapporter.

Resultatstatus

Feltet status på toppnivå i resultatsvaret viser den overordnede fremdriften i behandlingen: Enkeltresultater i svaret har sin egen status per resultat (se nedenfor), slik at du kan vise delresultater mens den overordnede statusen fortsatt er in_progress. Abonner på webhooks for å få beskjed når resultater endres. appointment.results.updated utløses ved hver endring i resultatinnholdet, og appointment.results.completed utløses når statusen på toppnivå går over til completed. Bestillinger av hjemmetestsett sender de samme hendelsene med prefikset home_kit_order.. Hver hendelse inneholder resultat-URL-en som skal hentes. Du kan fortsatt polle dette endepunktet for å avstemme. Listen submissions deler opp statusen på toppnivå per laboratorierekvisisjon. En blodprøvetaking som omfatter flere prøverør eller flere laboratorier, har flere oppføringer, hver med den lab_code (strekkoden på prøverøret) den ble registrert under, og sin egen status (in_progress / completed / fault). En oppføring med fault ble avvist eller forkastet hos laboratoriet og vil aldri rapportere: prøven ble ofte flyttet til et annet laboratorium, som deretter oppretter sin egen oppføring. Statusen på toppnivå er completed når alle oppføringer er avsluttet og minst én har rapportert. Hvert mottatt resultat og hvert dokument har samme lab_code, slik at du kan se hvilket prøverør en verdi kom fra.

Kliniske resultater

Kliniske resultater er vanlige målinger av biomarkører i blodet — som vitamin D-nivåer, kolesterol, stoffskiftehormoner og lignende. Hvert klinisk resultat inneholder:
  • id — identifikatoren for raden med laboratorieresultatet. Den forblir den samme når laboratoriet korrigerer raden, så bruk den til upsert. null for et planned-resultat.
  • biomarker_name og category — hva som ble målt, og grupperingen av det (f.eks. vitaminer, hormoner).
  • lab_code — laboratoriekoden (strekkoden på prøverøret) resultatet ble registrert under, en av bestillingens laboratoriekoder. null for et planned-resultat og for resultater som laboratoriet rapporterte uten kode.
  • value og value_operator — den faktiske målingen. Operatoren er eq (er lik) for eksakte verdier, eller lt/gt når laboratoriet rapporterer en verdi under eller over det målbare området.
  • unit — måleenheten (f.eks. ng/mL, µIU/mL).
  • reference_range_lab — normale og optimale min-/maksgrenser slik de ble rapportert av laboratoriet for dette resultatet, konvertert til samme skala som value. En grense laboratoriet lar stå åpen er null, slik at et ensidig intervall som < 50 kommer som normal_min: null, normal_max: 50. Hvert resultat har med seg intervallet det ble målt mot, slik at en pasient med resultater på tvers av flere blodprøvetakinger eller laboratorier får riktig intervall per resultat.
  • reference_range_lab_absent_reason — hvorfor reference_range_lab er null. null når referanseområdet finnes, og på et planned-resultat. Se Når det ikke finnes referanseområde fra laboratoriet.
  • aniva_range — Sammenligningsverdier som Aniva har satt sammen, på samme skala som value. De varierer etter alder, kjønn og svangerskapsuke. normal_* er det generelle området. optimal_* er et snevrere område. Verdiene er kun til informasjon. De er ikke medisinske råd, ikke en diagnose og ikke en vurdering av resultatet. Aniva setter ingen flagg mot dem. Bruk reference_range_lab som standard for resultatet. null når nøkkelen din ikke har scope aniva_ranges_view, eller når Aniva ikke har verdier for denne biomarkøren.
  • tested_at — datoen testen ble utført.
  • comment — fritekstkommentar fra laboratoriet om dette spesifikke resultatet (f.eks. veiledning om referanseområder, advarsler om prøvekvalitet). null når laboratoriet ikke la ved noen.
  • status_reason — hvorfor et likely_wrong-resultat er tvilsomt, eller hvorfor et fault- eller undeliverable-resultat er ubrukelig. null for alle andre statuser. Skiller seg fra comment, som er laboratoriets eget notat og ofte er tomt på resultater med feil.
  • origin — hvem som leverte dokumentet verdien kommer fra, med de samme verdiene som dokumentets origin nedenfor. En verdi fra et opplastet dokument (member_upload, staff_upload, partner_upload) kommer fra at Aniva leser filen, ikke fra en laboratorierapport: kontroller den mot filen før klinisk bruk. null for et planned-resultat.
  • lab_reported — det utførende laboratoriets egen rapportlinje, ordrett og ukonvertert. Se nedenfor.

Aniva-områder

aniva_range inneholder sammenligningsverdier som Aniva har satt sammen fra publiserte kilder og egen kuratering. Områdene varierer etter alder, kjønn og svangerskapsuke. sources lister opp de publiserte kildene Aniva har registrert for verdiene. Listen kan være tom.
Verdiene er generell informasjon. De er ikke medisinske råd, ikke en diagnose, ikke et medisinsk funn og ikke en vurdering av et resultat. Aniva tilbyr dem ikke som medisinsk utstyr. Aniva sammenligner ikke et resultat med dem og setter ingen flagg mot dem. reference_range_lab og vurderingen fra en lege forblir standarden for et resultat.
Regler for produktet ditt:
  • Vis Aniva-området kun i tillegg til laboratoriets område, aldri i stedet for det.
  • Hvis du utleder et flagg, en advarsel eller en anbefaling fra Aniva-området, gjør du dette i eget navn og på eget ansvar.
  • Vis merknaden fra avtalen din med Aniva overalt der du viser Aniva-området.
For å få tilgang må du signere den korte avtalen om Aniva-områder. Deretter legger vi til scope aniva_ranges_view på nøkkelen din. Verdiene kan endres uten varsel.

Normaliserte verdier kontra laboratoriets egen linje

value, unit og reference_range_lab er normalisert: vi konverterer hver måling til biomarkørens kanoniske enhet og rapporterer den under vårt eget biomarkørnavn, slik at den samme analytten kan sammenlignes på tvers av laboratorier og over tid. Det er dette du ønsker for trendanalyser og sammenligning på tvers av laboratorier, men det er ikke det en lege som gjennomgår svaret, ser på laboratoriets PDF — alkalisk fosfatase som står oppført som 48 U/l (40 - 129), kommer til deg som 0.8 µkat/L. lab_reported har med seg denne trykte linjen ved siden av: laboratoriets analyttnavn og kode, verdien og enheten slik de er trykt, referanseintervallet både som tekst (< 50, > 55, 40 - 129) og som laboratoriets egne ukonverterte grenser, i tillegg til avviksflagg, resultatstatus og notat. Bruk lab_reported når et menneske avstemmer dataene dine mot laboratoriets rapport, og de kanoniske feltene til alt som beregnes. Bare felt som laboratoriet faktisk sendte, fylles ut; ingenting i lab_reported utledes, får standardverdier eller konverteres, og hele objektet er null når vi ikke har noen rådata for et resultat.

Når det ikke finnes referanseområde fra laboratoriet

Når reference_range_lab er null, forteller reference_range_lab_absent_reason deg hvorfor: Noen laboratorier oppgir en målverdi eller et risikonivå i stedet for et referanseområde, for eksempel Ziel: <200. >240 hoch eller <5.7 neg >=6.5 pos. Disse legges ikke inn i reference_range_lab, så grensene er null og årsaken er lab_text_only. Vis den trykte teksten ordrett. Et ensidig område som < 20 er et referanseområde. Det kommer i reference_range_lab med én grense satt til null, og årsaken er null. La den åpne siden forbli åpen når du viser det.

Statuser for kliniske resultater

Når du viser resultater til pasienter, bruker du feltet value direkte — det gjenspeiler allerede den korrigerte verdien når det finnes en.
Presenter aldri et fault-resultat som et funn — value er fylt ut, men bekreftet feil.

Genetiske resultater

Genetiske resultater er funn på gennivå fra DNA-analyse. Hvert resultat tilsvarer et gen (f.eks. APOE, MTHFR) og inneholder:
  • id — identifikatoren for raden med laboratorieresultatet. Den forblir den samme når laboratoriet korrigerer raden, så bruk den til upsert. null for et planned-resultat.
  • gene — gensymbolet.
  • lab_code — laboratoriekoden (strekkoden på prøverøret) resultatet ble registrert under. null for et planned-resultat og for resultater som laboratoriet rapporterte uten kode.
  • genotype — den påviste genotypen (f.eks. E3/E4).
  • clinical_significance — en ACMG-basert klassifisering av funnet.
  • risk_description — en menneskelesbar forklaring på hva genotypen betyr.
  • comment — fritekstkommentar fra laboratoriet om dette spesifikke resultatet. null når laboratoriet ikke la ved noen.
  • status_reason — hvorfor et likely_wrong-resultat er tvilsomt, eller hvorfor et fault- eller undeliverable-resultat er ubrukelig. null for alle andre statuser.
  • origin — hvem som leverte dokumentet verdien kommer fra, som for kliniske resultater.
  • variants — de spesifikke genetiske variantene som er påvist, hver med detaljer på SNV-nivå.

Verdier for klinisk signifikans

Statuser for genetiske resultater

Variantstruktur

Hvert genetisk resultat inneholder en variants-liste. Hver variant inkluderer:
  • name – vanlig navn (f.eks. APOE E4).
  • clinical_significance – betydning på variantnivå (kan avvike fra betydningen på gennivå).
  • conditions – tilknyttede sykdommer/tilstander med beskrivelser.
  • snvs – de underliggende enkeltnukleotidvariantene, hver med rs_id, allele, reference_allele og valgfri HGVS-notasjon.

Dokumenter

documents-listen i resultatresponsen inneholder referanser til nedlastbare filer med laboratorierapporter. Hvert dokument har:
  • id – en fil-UUID. Send denne til GET /api/v1/documents/{id} for å laste ned filen.
  • file_name – filnavnet, det samme som nedlastingen sender (f.eks. 20260405 - Quade Befund - 7642001234.pdf).
  • original_file_name – filnavnet nøyaktig slik laboratoriet eller opplasteren leverte det (f.eks. 7642001234_B0012_FA_E.pdf).
  • origin – hvem som leverte filen: lab, member_upload, staff_upload eller partner_upload (du lastet den opp med Last opp dokument).
  • content_type – filens medietype (f.eks. application/pdf). De fleste rapporter er PDF-filer. Opplastede skanninger kan være bilder eller CSV-filer.
  • etag – versjonen av filinnholdet; den endres hver gang bytene endres. Lagre den og last ned på nytt bare når den endres. Det er standard HTTP entity tag, slik S3 eller Google Cloud Storage bruker den.
  • size_bytes – filstørrelsen i byte.
  • lab_code – labkoden (strekkoden på prøverøret) rapporten tilhører; null når laboratoriet ikke registrerte noen.
Tilgang til dokumenter valideres mot profilen som eier dokumentet.

Sende resultater på e-post til kunden

Du kan gi kunden beskjed på e-post om at resultatene er klare. Kall Send resultater på e-post for en time, eller Send resultater på e-post for en bestilling av hjemmetestsett. Hvert kall sender én e-post. Kall dedupliseres ikke.
  • E-posten sendes til profilens email. En plassholderadresse med @aniva.email avvises.
  • E-posten viser navnet og logoen til profilens primære profilgruppe.
  • E-posten er på profilens language, med engelsk som standard.
  • Sett with_reports til true for å legge ved labrapportene.
  • Legg til note for å vise en personlig melding i e-posten, maksimalt 1 000 tegn.
Hvis profilen har slått av transaksjonelle e-poster, returnerer kallet 409 med årsaken unsubscribed. For å slå dem på igjen setter du transactional_emails_enabled til true med Oppdater profil.

E-poster når resultater er klare

Du kan få en e-post når resultatene for en bestilling er klare. Sett results_ready_emails til opptil 5 adresser i Opprett time eller Opprett bestilling av hjemmetestsett. Endre listen senere med Oppdater time eller Oppdater bestilling av hjemmetestsett; [] slår av e-postene.
  • Be oss sette standard e-postadresser for profilgruppen din. En bestilling som opprettes uten results_ready_emails, får disse. En liste erstatter dem for den bestillingen, så ta med standard e-postadresse for å beholde den. [] sender ingen e-post.
  • Hver adresse får én e-post så snart alle laboratorieresultatene for bestillingen er endelige.
  • En adresse som legges til etter at resultatene er endelige, får e-posten med en gang.
  • E-posten lenker til resultatsiden i Anivas adminpanel. Kunden får den ikke.
  • Nøkkelen din trenger results_view-tilgang til pasienten. Uten den returnerer forespørselen 403.

Vis resultater i appen din

Opprett innbyggingsøkt returnerer en engangs-URL til en skrivebeskyttet resultatside. Åpne den i en WebView i appen din, så ser pasienten resultatene uten å logge inn.
  • Nøkkelen din trenger scopene embed og results_view for pasienten. Be Aniva om embed-scopet.
  • Kall den fra serveren din hver gang pasienten åpner resultatene. URL-en fungerer én gang og i 5 minutter, og siden holder deretter en økt på 60 minutter.
  • route åpner en av sidene vi tilgjengeliggjør: biomarkørlisten, én biomarkør eller 3D Twin.
  • appearance setter temaet, fargen på knapper og lenker, og om logoen din vises.
  • report begrenser siden til én time, én bestilling av hjemmetestsett eller én laboratorierapport som du lastet opp med POST /api/v1/documents. Pasienten ser da bare resultatene fra den rapporten.
  • Siden viser bare laboratorieresultater, i likhet med dette API-et. Den viser ingen filer, ingen chat og ingen innstillinger.

Eksempel på resultatrespons