Spring til hovedindhold
Når en blodprøvetagning er bekræftet, og laboratoriet har behandlet prøverne, bliver resultaterne tilgængelige på tiden. Resultater hentes via GET /api/v1/appointments/{id}/results og omfatter kliniske biomarkørresultater, genetiske biomarkørresultater samt laboratorierapporter, der kan downloades.

Resultatstatus

Feltet status på øverste niveau i resultatsvaret angiver den samlede behandlingsstatus: De enkelte resultater i svaret har deres egen status pr. resultat (se nedenfor), så du kan vise delresultater, mens den samlede status stadig er in_progress. Abonner på webhooks for at få besked, når resultater ændrer sig. appointment.results.updated udløses ved hver ændring i resultatindholdet, og appointment.results.completed udløses, når status på øverste niveau skifter til completed. Ordrer på hjemmetestkit sender de samme hændelser med præfikset home_kit_order.. Hver hændelse indeholder URL’en til de resultater, der skal hentes. Du kan stadig polle dette endpoint for at afstemme. Arrayet submissions opdeler status på øverste niveau pr. laboratorierekvisition. En blodprøvetagning, der omfatter flere rør eller flere laboratorier, har flere poster, hver med den lab_code (rørstregkode), den blev indsendt under, og sin egen in_progress / completed / fault-status. En fault-post blev afvist eller opgivet på laboratoriet og vil aldrig rapportere: Prøven er ofte blevet flyttet til et andet laboratorium, som derefter opretter sin egen post. Status på øverste niveau er completed, når alle poster er afsluttet, og mindst én har rapporteret. Hvert modtaget resultat og hvert dokument har den samme lab_code, så du kan se, hvilket rør en værdi kommer fra.

Kliniske resultater

Kliniske resultater er almindelige målinger af biomarkører i blodet — såsom D-vitaminniveau, kolesterol, stofskiftehormoner og lignende. Hvert klinisk resultat indeholder:
  • id — id’et for resultatrækken fra laboratoriet. Det forbliver det samme, når laboratoriet retter rækken, så brug det til upsert. null for et planned-resultat.
  • biomarker_name og category — hvad der blev målt, og hvilken gruppe det hører under (f.eks. vitaminer, hormoner).
  • lab_code — den laboratoriekode (rørstregkode), resultatet blev indsendt under, en af ordrens laboratoriekoder. null for et planned-resultat og for resultater, laboratoriet rapporterede uden kode.
  • value og value_operator — selve målingen. Operatoren er eq (lig med) for eksakte værdier eller lt/gt, når laboratoriet rapporterer en værdi under eller over det målbare område.
  • unit — måleenheden (f.eks. ng/mL, µIU/mL).
  • reference_range_lab — normale og optimale min.- og maks.-grænser som rapporteret af laboratoriet for dette resultat, omregnet til samme skala som value. En grænse, som laboratoriet lader stå åben, er null, så et ensidigt interval som < 50 kommer som normal_min: null, normal_max: 50. Hvert resultat har det interval, det blev målt op imod, så en patient med resultater fra flere blodprøvetagninger eller laboratorier får det rigtige pr. resultat.
  • reference_range_lab_absent_reason — hvorfor reference_range_lab er null. null, når intervallet er til stede, samt på et planned-resultat. Se Når der ikke er noget laboratorieinterval.
  • aniva_range — sammenligningsværdier, som Aniva har samlet, på samme skala som value. De varierer efter alder, køn og graviditetsuge. normal_* er det generelle interval. optimal_* er et smallere interval. Værdierne er kun til information. De er ikke lægefaglig rådgivning, ikke en diagnose og ikke en vurdering af resultatet. Aniva sætter ingen markering ud fra dem. Brug reference_range_lab som standard for resultatet. null, når din nøgle ikke har scopet aniva_ranges_view, eller når Aniva ikke har værdier for denne biomarkør.
  • tested_at — datoen for, hvornår testen blev udført.
  • comment — fritekstbemærkning fra laboratoriet til dette specifikke resultat (f.eks. vejledning om referenceinterval, advarsler om prøvekvalitet). null, når laboratoriet ikke har vedhæftet en.
  • status_reason — hvorfor et likely_wrong-resultat er tvivlsomt, eller hvorfor et fault- eller undeliverable-resultat er ubrugeligt. null for alle andre statusser. Adskiller sig fra comment, som er laboratoriets egen note og ofte er tom ved fejlbehæftede resultater.
  • origin — hvem der leverede dokumentet, som værdien stammer fra, med de samme værdier som dokumentets origin nedenfor. En værdi fra et uploadet dokument (member_upload, staff_upload, partner_upload) kommer fra, at Aniva aflæser filen, ikke fra en laboratorierapport: Tjek den op imod filen før klinisk brug. null for et planned-resultat.
  • lab_reported — det udførende laboratoriums egen rapportlinje, ordret og uomregnet. Se nedenfor.

Aniva-intervaller

aniva_range indeholder sammenligningsværdier, som Aniva har samlet fra publicerede kilder og egen kuratering. Intervallerne varierer efter alder, køn og graviditetsuge. sources viser de publicerede kilder, som Aniva har registreret for værdierne. Listen kan være tom.
Værdierne er generel information. De er ikke lægefaglig rådgivning, ikke en diagnose, ikke et medicinsk fund og ikke en vurdering af et resultat. Aniva stiller dem ikke til rådighed som medicinsk udstyr. Aniva sammenligner ikke et resultat med dem og sætter ingen markering ud fra dem. reference_range_lab og en læges vurdering forbliver standarden for et resultat.
Regler for dit produkt:
  • Vis kun Aniva-intervallet som supplement til laboratoriets interval, aldrig i stedet for det.
  • Hvis du udleder en markering, en advarsel eller en anbefaling fra Aniva-intervallet, gør du det i eget navn og på eget ansvar.
  • Vis meddelelsen fra din aftale med Aniva, overalt hvor du viser Aniva-intervallet.
For at få adgang skal du underskrive den korte aftale om Aniva-intervaller. Derefter tilføjer vi scopet aniva_ranges_view til din nøgle. Værdierne kan ændres uden varsel.

Normaliserede værdier versus laboratoriets egen linje

value, unit og reference_range_lab er normaliserede: Vi omregner hver måling til biomarkørens standardenhed og rapporterer den under vores eget biomarkørnavn, så den samme analyt kan sammenlignes på tværs af laboratorier og over tid. Det er det, du har brug for til tendenser og sammenligning på tværs af laboratorier, men det er ikke det, en læge, der gennemgår svaret, ser på laboratoriets PDF — basisk fosfatase udskrevet som 48 U/l (40 - 129) når frem til dig som 0.8 µkat/L. lab_reported indeholder den udskrevne linje ved siden af: laboratoriets analytnavn og -kode, værdi og enhed som udskrevet, referenceintervallet både som tekst (< 50, > 55, 40 - 129) og som laboratoriets egne uomregnede grænser samt dets afvigelsesmarkering, resultatstatus og note. Brug lab_reported, når et menneske afstemmer dine data med laboratoriets rapport, og standardfelterne til alt, der beregnes. Kun felter, som laboratoriet faktisk har sendt, udfyldes; intet i lab_reported udledes, får standardværdier eller omregnes, og hele objektet er null, når vi ikke har nogen rådata for et resultat.

Når der ikke er noget laboratorieinterval

Når reference_range_lab er null, fortæller reference_range_lab_absent_reason dig hvorfor: Nogle laboratorier udskriver et mål eller et risikoniveau i stedet for et referenceinterval, for eksempel Ziel: <200. >240 hoch eller <5.7 neg >=6.5 pos. Disse kommer ikke med i reference_range_lab, så grænserne er null, og årsagen er lab_text_only. Vis den udskrevne tekst ordret. Et ensidigt interval som < 20 er et interval. Det kommer i reference_range_lab med én grænse sat til null, og årsagen er null. Hold den åbne side åben, når du viser det.

Statusser for kliniske resultater

Brug feltet value direkte, når du viser resultater til patienter — det afspejler allerede den rettede værdi, når der findes en.
Vis aldrig et fault-resultat som et fund — dets value er udfyldt, men bekræftet forkert.

Genetiske resultater

Genetiske resultater er fund på genniveau fra en DNA-analyse. Hvert resultat svarer til et gen (f.eks. APOE, MTHFR) og indeholder:
  • id — id’et for resultatrækken fra laboratoriet. Det forbliver det samme, når laboratoriet retter rækken, så brug det til upsert. null for et planned-resultat.
  • gene — gensymbolet.
  • lab_code — den laboratoriekode (rørstregkode), resultatet blev indsendt under. null for et planned-resultat og for resultater, laboratoriet rapporterede uden kode.
  • genotype — den påviste genotype (f.eks. E3/E4).
  • clinical_significance — en ACMG-baseret klassificering af fundet.
  • risk_description — en letlæselig forklaring på, hvad genotypen betyder.
  • comment — fritekstbemærkning fra laboratoriet til dette specifikke resultat. null, når laboratoriet ikke har vedhæftet en.
  • status_reason — hvorfor et likely_wrong-resultat er tvivlsomt, eller hvorfor et fault- eller undeliverable-resultat er ubrugeligt. null for alle andre statusser.
  • origin — hvem der leverede dokumentet, som værdien stammer fra, ligesom ved kliniske resultater.
  • variants — de specifikke påviste genetiske varianter, hver med detaljer på SNV-niveau.

Værdier for klinisk signifikans

Statusser for genetiske resultater

Variantstruktur

Hvert genetisk resultat indeholder et variants-array. Hver variant omfatter:
  • name — almindeligt navn (f.eks. APOE E4).
  • clinical_significance — betydning på variantniveau (kan afvige fra betydningen på genniveau).
  • conditions — tilknyttede sygdomme/tilstande med beskrivelser.
  • snvs — de underliggende enkeltnukleotidvarianter, hver med rs_id, allele, reference_allele og valgfri HGVS-notation.

Dokumenter

Arrayet documents i resultatsvaret indeholder referencer til laboratorierapportfiler, der kan downloades. Hvert dokument har:
  • id — en fil-UUID. Send denne til GET /api/v1/documents/{id} for at downloade filen.
  • file_name — filnavnet, det samme som downloadet sender (f.eks. 20260405 - Quade Befund - 7642001234.pdf).
  • original_file_name — filnavnet præcis som laboratoriet eller uploaderen leverede det (f.eks. 7642001234_B0012_FA_E.pdf).
  • origin — hvem der leverede filen: lab, member_upload, staff_upload eller partner_upload (du uploadede den med Upload dokument).
  • content_type — filens medietype (f.eks. application/pdf). De fleste rapporter er PDF’er. Uploadede scanninger kan være billeder eller CSV-filer.
  • etag — versionen af filindholdet; den ændres, hver gang bytene ændres. Gem den, og download kun igen, når den ændres. Det er et standard HTTP entity tag, som bruges af S3 eller Google Cloud Storage.
  • size_bytes — filstørrelsen i bytes.
  • lab_code — laboratoriekoden (prøveglassets stregkode), som rapporten tilhører; null, når laboratoriet ikke har angivet nogen.
Adgang til dokumenter valideres mod den profil, der ejer dokumentet.

Send resultater til kunden på e-mail

Du kan give kunden besked på e-mail om, at resultaterne er klar. Kald Send resultater på e-mail for en tid eller Send resultater på e-mail for en hjemmetestkitordre. Hvert kald sender én e-mail. Kald deduplikeres ikke.
  • E-mailen sendes til profilens email. En pladsholderadresse med @aniva.email afvises.
  • E-mailen viser navnet og logoet for profilens primære profilgruppe.
  • E-mailen er på profilens language, engelsk som standard.
  • Sæt with_reports til true for at vedhæfte laboratorierapporterne.
  • Tilføj note for at vise en personlig note i e-mailen, højst 1.000 tegn.
Hvis profilen har slået transaktionelle e-mails fra, returnerer kaldet 409 med årsagen unsubscribed. For at slå dem til igen skal du sætte transactional_emails_enabled til true med Opdater profil.

E-mails, når resultater er klar

Du kan få en e-mail, når resultaterne for en booking er klar. Sæt results_ready_emails til op til 5 adresser i Opret tid eller Opret hjemmetestkitordre. Rediger listen senere med Opdater tid eller Opdater hjemmetestkitordre; [] slår e-mailsene fra.
  • Bed os om at angive standard-e-mailadresser for din profilgruppe. En booking oprettet uden results_ready_emails får dem. En liste erstatter dem for den pågældende booking, så medtag din standard-e-mailadresse for at beholde den. [] sender ingen e-mail.
  • Hver adresse får én e-mail, når alle laboratorieresultater for bookingen er endelige.
  • En adresse, der tilføjes, efter at resultaterne er endelige, får e-mailen med det samme.
  • E-mailen linker til resultatsiden i Anivas adminpanel. Kunden modtager den ikke.
  • Din nøgle skal have results_view-adgang til patienten. Uden den returnerer forespørgslen 403.

Vis resultater i din app

Opret embed-session returnerer en engangs-URL til en skrivebeskyttet resultatside. Åbn den i en WebView i din app, så patienten ser resultaterne uden at logge ind.
  • Din nøgle skal have embed- og results_view-scopes for patienten. Bed Aniva om embed-scopet.
  • Kald den fra din server, hver gang patienten åbner resultaterne. URL’en virker én gang og i 5 minutter, og siden holder derefter en 60-minutters session.
  • route åbner en af de sider, vi frigiver: biomarkørlisten, én biomarkør eller 3D Twin.
  • appearance styrer temaet, farven på knapper og links, og om dit logo vises.
  • report begrænser siden til én tid, én hjemmetestkitordre eller én laboratorierapport, som du har uploadet med POST /api/v1/documents. Patienten ser derefter kun resultaterne fra den rapport.
  • Siden viser kun laboratorieresultater, ligesom dette API. Den viser ingen filer, ingen chat og ingen indstillinger.

Eksempel på resultatsvar