GET /api/v1/appointments/{id}/results og omfatter kliniske biomarkørresultater, genetiske biomarkørresultater samt laboratorierapporter, der kan downloades.
Resultatstatus
Feltetstatus 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.nullfor etplanned-resultat.biomarker_nameogcategory— 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.nullfor etplanned-resultat og for resultater, laboratoriet rapporterede uden kode.valueogvalue_operator— selve målingen. Operatoren ereq(lig med) for eksakte værdier ellerlt/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 somvalue. En grænse, som laboratoriet lader stå åben, ernull, så et ensidigt interval som< 50kommer somnormal_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— hvorforreference_range_labernull.null, når intervallet er til stede, samt på etplanned-resultat. Se Når der ikke er noget laboratorieinterval.aniva_range— sammenligningsværdier, som Aniva har samlet, på samme skala somvalue. 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. Brugreference_range_labsom standard for resultatet.null, når din nøgle ikke har scopetaniva_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 etlikely_wrong-resultat er tvivlsomt, eller hvorfor etfault- ellerundeliverable-resultat er ubrugeligt.nullfor alle andre statusser. Adskiller sig fracomment, 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 dokumentetsoriginnedenfor. 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.nullfor etplanned-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.
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.
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årreference_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
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.nullfor etplanned-resultat.gene— gensymbolet.lab_code— den laboratoriekode (rørstregkode), resultatet blev indsendt under.nullfor etplanned-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 etlikely_wrong-resultat er tvivlsomt, eller hvorfor etfault- ellerundeliverable-resultat er ubrugeligt.nullfor 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 etvariants-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 medrs_id,allele,reference_alleleog valgfri HGVS-notation.
Dokumenter
Arrayetdocuments i resultatsvaret indeholder referencer til laboratorierapportfiler, der kan downloades. Hvert dokument har:
id— en fil-UUID. Send denne tilGET /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_uploadellerpartner_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.emailafvises. - E-mailen viser navnet og logoet for profilens primære profilgruppe.
- E-mailen er på profilens
language, engelsk som standard. - Sæt
with_reportstiltruefor at vedhæfte laboratorierapporterne. - Tilføj
notefor at vise en personlig note i e-mailen, højst 1.000 tegn.
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ætresults_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_emailsfå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ørgslen403.
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- ogresults_view-scopes for patienten. Bed Aniva omembed-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.appearancestyrer temaet, farven på knapper og links, og om dit logo vises.reportbegrænser siden til én tid, én hjemmetestkitordre eller én laboratorierapport, som du har uploadet medPOST /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.