GET /api/v1/appointments/{id}/results og inkluderer kliniske biomarkørresultater, genetiske biomarkørresultater og nedlastbare laboratorierapporter.
Resultatstatus
Feltetstatus 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.nullfor etplanned-resultat.biomarker_nameogcategory— 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.nullfor etplanned-resultat og for resultater som laboratoriet rapporterte uten kode.valueogvalue_operator— den faktiske målingen. Operatoren ereq(er lik) for eksakte verdier, ellerlt/gtnå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 somvalue. En grense laboratoriet lar stå åpen ernull, slik at et ensidig intervall som< 50kommer somnormal_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— hvorforreference_range_labernull.nullnår referanseområdet finnes, og på etplanned-resultat. Se Når det ikke finnes referanseområde fra laboratoriet.aniva_range— Sammenligningsverdier som Aniva har satt sammen, på samme skala somvalue. 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. Brukreference_range_labsom standard for resultatet.nullnår nøkkelen din ikke har scopeaniva_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).nullnår laboratoriet ikke la ved noen.status_reason— hvorfor etlikely_wrong-resultat er tvilsomt, eller hvorfor etfault- ellerundeliverable-resultat er ubrukelig.nullfor alle andre statuser. Skiller seg fracomment, 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 dokumentetsoriginnedenfor. 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.nullfor etplanned-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.
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.
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årreference_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
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.nullfor etplanned-resultat.gene— gensymbolet.lab_code— laboratoriekoden (strekkoden på prøverøret) resultatet ble registrert under.nullfor etplanned-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.nullnår laboratoriet ikke la ved noen.status_reason— hvorfor etlikely_wrong-resultat er tvilsomt, eller hvorfor etfault- ellerundeliverable-resultat er ubrukelig.nullfor 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 envariants-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 medrs_id,allele,reference_alleleog valgfri HGVS-notasjon.
Dokumenter
documents-listen i resultatresponsen inneholder referanser til nedlastbare filer med laboratorierapporter. Hvert dokument har:
id– en fil-UUID. Send denne tilGET /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_uploadellerpartner_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;nullnå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.emailavvises. - E-posten viser navnet og logoen til profilens primære profilgruppe.
- E-posten er på profilens
language, med engelsk som standard. - Sett
with_reportstiltruefor å legge ved labrapportene. - Legg til
notefor å vise en personlig melding i e-posten, maksimalt 1 000 tegn.
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. Settresults_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ørselen403.
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
embedogresults_viewfor pasienten. Be Aniva omembed-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.appearancesetter temaet, fargen på knapper og lenker, og om logoen din vises.reportbegrenser siden til én time, én bestilling av hjemmetestsett eller én laboratorierapport som du lastet opp medPOST /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.