Salt la conținutul principal
După ce o recoltare de sânge este confirmată și laboratorul procesează probele, rezultatele devin disponibile în programare. Rezultatele se preiau prin GET /api/v1/appointments/{id}/results și includ rezultate de biomarkeri clinici, rezultate de biomarkeri genetici și documente descărcabile cu rapoarte de laborator.

Statusul rezultatelor

Câmpul status de nivel superior din răspunsul cu rezultate indică progresul general al procesării: Rezultatele individuale din răspuns au propriul status per rezultat (vezi mai jos), astfel încât poți afișa rezultate parțiale cât timp statusul general este încă in_progress. Pentru a afla când se modifică rezultatele, abonează-te la webhook-uri. appointment.results.updated se declanșează la fiecare modificare a corpului rezultatelor, iar appointment.results.completed se declanșează când statusul de nivel superior trece în completed. Comenzile de kituri de testare la domiciliu trimit aceleași evenimente cu prefixul home_kit_order.. Fiecare eveniment conține URL-ul rezultatelor de preluat. Poți în continuare să interoghezi periodic acest endpoint pentru reconciliere. Array-ul submissions detaliază statusul de nivel superior pentru fiecare cerere de laborator. O recoltare de sânge care implică mai multe eprubete sau mai multe laboratoare are mai multe intrări, fiecare cu codul lab_code (codul de bare al eprubetei) sub care a fost înregistrată și propriul status in_progress / completed / fault. O intrare fault a fost respinsă sau abandonată la laborator și nu va raporta niciodată: proba a fost adesea mutată la alt laborator, care înregistrează apoi propria intrare. Statusul de nivel superior este completed când fiecare intrare s-a încheiat și cel puțin una a raportat. Fiecare rezultat primit și fiecare document poartă același lab_code, astfel încât poți ști din ce eprubetă provine o valoare.

Rezultate clinice

Rezultatele clinice reprezintă măsurători standard de biomarkeri din sânge — lucruri precum nivelul de vitamina D, colesterolul, hormonii tiroidieni și așa mai departe. Fiecare rezultat clinic include:
  • id — identificatorul rândului de rezultat de laborator. Rămâne același când laboratorul corectează acel rând, așa că folosește-l pentru upsert. null pentru un rezultat planned.
  • biomarker_name și category — ce s-a măsurat și categoria aferentă (de ex., Vitamine, Hormoni).
  • lab_code — codul de laborator (codul de bare al eprubetei) sub care a fost înregistrat rezultatul, unul dintre codurile de laborator ale comenzii. null pentru un rezultat planned și pentru rezultatele raportate de laborator fără cod.
  • value și value_operator — măsurătoarea efectivă. Operatorul este eq (egal) pentru valori exacte sau lt/gt când laboratorul raportează o valoare sub sau peste intervalul măsurabil.
  • unit — unitatea de măsură (de ex., ng/mL, µIU/mL).
  • reference_range_lab — limitele min/max normale și optime raportate de laborator pentru acest rezultat, convertite pe aceeași scară ca value. O limită lăsată deschisă de laborator este null, astfel că un interval unilateral precum < 50 ajunge ca normal_min: null, normal_max: 50. Fiecare rezultat poartă intervalul față de care a fost măsurat, astfel încât un pacient cu rezultate din mai multe recoltări de sânge sau laboratoare primește intervalul corect pentru fiecare rezultat.
  • reference_range_lab_absent_reason — motivul pentru care reference_range_lab este null. null când intervalul este prezent și pentru un rezultat planned. Vezi Când nu există interval de laborator.
  • aniva_range — Valori de comparație compilate de Aniva, pe aceeași scară ca value. Diferă în funcție de vârstă, sex și săptămâna de sarcină. normal_* este intervalul general. optimal_* este un interval mai restrâns. Valorile au doar scop informativ. Nu sunt sfaturi medicale, nu sunt un diagnostic și nu reprezintă o evaluare a rezultatului. Aniva nu setează niciun indicator pe baza lor. Folosește reference_range_lab ca standard pentru rezultat. null când cheia ta nu are scope-ul aniva_ranges_view sau când Aniva nu are valori pentru acest biomarker.
  • tested_at — data la care a fost efectuat testul.
  • comment — adnotare de tip text liber de la laborator pentru acest rezultat specific (de ex., indicații privind intervalul de referință, avertizări privind calitatea probei). null când laboratorul nu a atașat niciuna.
  • status_reason — motivul pentru care un rezultat likely_wrong este îndoielnic sau un rezultat fault ori undeliverable este inutilizabil. null pentru orice alt status. Distinct de comment, care este nota proprie a laboratorului și este adesea goală pentru rezultatele cu eroare.
  • origin — cine a livrat documentul din care provine valoarea, aceleași valori ca origin al documentului de mai jos. O valoare dintr-un document încărcat (member_upload, staff_upload, partner_upload) provine din citirea fișierului de către Aniva, nu dintr-un raport de laborator: verific-o față de fișier înainte de utilizarea clinică. null pentru un rezultat planned.
  • lab_reported — linia proprie de raportare a laboratorului care a efectuat analiza, exact așa cum a fost raportată și neconvertită. Vezi mai jos.

Intervalele Aniva

aniva_range conține valori de comparație compilate de Aniva din surse publicate și din selecția proprie. Intervalele diferă în funcție de vârstă, sex și săptămâna de sarcină. sources enumeră sursele publicate pe care Aniva le-a înregistrat pentru aceste valori. Lista poate fi goală.
Valorile sunt informații generale. Nu sunt sfaturi medicale, nu sunt un diagnostic, nu sunt o constatare medicală și nu reprezintă o evaluare a unui rezultat. Aniva nu le oferă ca dispozitiv medical. Aniva nu compară un rezultat cu acestea și nu setează niciun indicator pe baza lor. reference_range_lab și evaluarea unui medic rămân standardul pentru un rezultat.
Reguli pentru produsul tău:
  • Afișează intervalul Aniva doar în completarea intervalului de laborator, niciodată în locul acestuia.
  • Dacă derivezi un indicator, o avertizare sau o recomandare din intervalul Aniva, faci acest lucru în nume propriu și pe propria răspundere.
  • Afișează mențiunea din acordul tău cu Aniva oriunde afișezi intervalul Aniva.
Pentru a primi acces, semnează acordul scurt privind intervalele Aniva. Adăugăm apoi scope-ul aniva_ranges_view la cheia ta. Valorile se pot modifica fără notificare prealabilă.

Valori normalizate față de linia proprie a laboratorului

value, unit și reference_range_lab sunt normalizate: convertim fiecare măsurătoare în unitatea canonică a biomarkerului și o raportăm sub propria noastră denumire de biomarker, astfel încât același analit să fie comparabil între laboratoare și în timp. Asta îți dorești pentru urmărirea tendințelor și compararea între laboratoare, dar nu este ceea ce vede un medic evaluator pe PDF-ul laboratorului — fosfataza alcalină tipărită ca 48 U/l (40 - 129) ajunge la tine ca 0.8 µkat/L. lab_reported poartă acea linie tipărită alături: denumirea și codul analitului din laborator, valoarea și unitatea așa cum au fost tipărite, intervalul de referință atât ca text (< 50, > 55, 40 - 129), cât și ca limitele proprii neconvertite ale laboratorului, plus indicatorul de valoare anormală, statusul rezultatului și nota. Folosește lab_reported când o persoană reconciliază datele tale cu raportul laboratorului, iar câmpurile canonice pentru tot ce este calculat. Sunt completate doar câmpurile pe care laboratorul le-a trimis efectiv; nimic din lab_reported nu este dedus, completat cu valori implicite sau convertit, iar întregul obiect este null când nu deținem o înregistrare brută pentru un rezultat.

Când nu există interval de laborator

Când reference_range_lab este null, reference_range_lab_absent_reason îți spune de ce: Unele laboratoare tipăresc o țintă sau un nivel de risc în locul unui interval de referință, de exemplu Ziel: <200. >240 hoch sau <5.7 neg >=6.5 pos. Acestea nu intră în reference_range_lab, deci limitele sale sunt null, iar motivul este lab_text_only. Afișează textul tipărit exact ca atare. Un interval unilateral precum < 20 este un interval. Ajunge în reference_range_lab cu o limită null, iar motivul este null. Păstrează capătul deschis ca atare când îl afișezi.

Statusurile rezultatelor clinice

Când afișezi rezultatele pacienților, folosește direct câmpul value — acesta reflectă deja valoarea corectată atunci când există una.
Nu prezenta niciodată un rezultat fault ca o constatare — câmpul value este completat, dar confirmat incorect.

Rezultate genetice

Rezultatele genetice reprezintă constatări la nivel de genă din analiza ADN. Fiecare rezultat corespunde unei gene (de ex., APOE, MTHFR) și include:
  • id — identificatorul rândului de rezultat de laborator. Rămâne același când laboratorul corectează acel rând, așa că folosește-l pentru upsert. null pentru un rezultat planned.
  • gene — simbolul genei.
  • lab_code — codul de laborator (codul de bare al eprubetei) sub care a fost înregistrat rezultatul. null pentru un rezultat planned și pentru rezultatele raportate de laborator fără cod.
  • genotype — genotipul detectat (de ex., E3/E4).
  • clinical_significance — o clasificare a constatării bazată pe ACMG.
  • risk_description — o explicație ușor de citit despre ce înseamnă genotipul.
  • comment — adnotare de tip text liber de la laborator pentru acest rezultat specific. null când laboratorul nu a atașat niciuna.
  • status_reason — motivul pentru care un rezultat likely_wrong este îndoielnic sau un rezultat fault ori undeliverable este inutilizabil. null pentru orice alt status.
  • origin — cine a livrat documentul din care provine valoarea, la fel ca la rezultatele clinice.
  • variants — variantele genetice specifice detectate, fiecare cu detalii la nivel de SNV.

Valori pentru semnificația clinică

Statusurile rezultatelor genetice

Structura variantei

Fiecare rezultat genetic conține un array variants. Fiecare variantă include:
  • name — denumirea comună (de ex., APOE E4).
  • clinical_significance — semnificația la nivel de variantă (poate diferi de semnificația la nivel de genă).
  • conditions — bolile/afecțiunile asociate, cu descrieri.
  • snvs — variantele de un singur nucleotid aferente, fiecare cu rs_id, allele, reference_allele și notație HGVS opțională.

Documente

Array-ul documents din răspunsul cu rezultate conține referințe la fișierele descărcabile ale rapoartelor de laborator. Fiecare document are:
  • id — un UUID de fișier. Trimite-l către GET /api/v1/documents/{id} pentru a descărca fișierul.
  • file_name — numele fișierului, același pe care îl trimite descărcarea (de ex., 20260405 - Quade Befund - 7642001234.pdf).
  • original_file_name — numele fișierului exact așa cum l-a livrat laboratorul sau persoana care l-a încărcat (de ex., 7642001234_B0012_FA_E.pdf).
  • origin — cine a livrat fișierul: lab, member_upload, staff_upload sau partner_upload (l-ai încărcat cu Încarcă document).
  • content_type — tipul media al fișierului (de ex., application/pdf). Majoritatea rapoartelor sunt PDF-uri. Scanările încărcate pot fi imagini sau fișiere CSV.
  • etag — versiunea conținutului fișierului; se schimbă ori de câte ori se schimbă octeții. Stocheaz-o și descarcă din nou doar când se schimbă. Este eticheta de entitate HTTP standard, așa cum este folosită de S3 sau Google Cloud Storage.
  • size_bytes — dimensiunea fișierului în octeți.
  • lab_code — codul de laborator (codul de bare al eprubetei) căruia îi aparține raportul; null când laboratorul nu a înregistrat niciunul.
Accesul la documente este validat în funcție de profilul care deține documentul.

Trimiterea rezultatelor prin e-mail către client

Poți anunța clientul prin e-mail că rezultatele sale sunt gata. Apelează Trimite rezultatele prin e-mail pentru o programare sau Trimite rezultatele prin e-mail pentru o comandă de kit de testare la domiciliu. Fiecare apel trimite un e-mail. Apelurile nu sunt deduplicate.
  • E-mailul este trimis la adresa email a profilului. O adresă provizorie @aniva.email este refuzată.
  • E-mailul afișează numele și logo-ul grupului principal de profiluri al profilului.
  • E-mailul este în limba language a profilului, implicit engleză.
  • Setează with_reports la true pentru a atașa rapoartele de laborator.
  • Adaugă note pentru a afișa o notă personală în e-mail, de cel mult 1.000 de caractere.
Dacă profilul a dezactivat e-mailurile tranzacționale, apelul returnează 409 cu motivul unsubscribed. Pentru a le activa din nou, setează transactional_emails_enabled pe true cu Actualizează profilul.

E-mailuri când rezultatele sunt gata

Poți primi un e-mail când rezultatele unei rezervări sunt gata. Setează results_ready_emails cu până la 5 adrese în Creează programare sau Creează comandă de kit de testare la domiciliu. Modifică lista mai târziu cu Actualizează programarea sau Actualizează comanda de kit de testare la domiciliu; [] dezactivează e-mailurile.
  • Roagă-ne să setăm adrese de e-mail implicite pentru grupul tău de profiluri. O rezervare creată fără results_ready_emails le primește pe acestea. O listă le înlocuiește pentru acea rezervare, așa că include adresa ta de e-mail implicită pentru a o păstra. [] nu trimite niciun e-mail.
  • Fiecare adresă primește un e-mail, odată ce toate rezultatele de laborator ale rezervării sunt finale.
  • O adresă adăugată după ce rezultatele sunt finale primește e-mailul imediat.
  • E-mailul conține un link către pagina de rezultate din panoul de administrare Aniva. Clientul nu îl primește.
  • Cheia ta are nevoie de acces results_view la pacient. Fără acesta, cererea returnează 403.

Afișează rezultatele în aplicația ta

Creează sesiune embed returnează un URL de unică folosință pentru o pagină de rezultate doar în citire. Deschide-l într-un WebView al aplicației tale, ca pacientul să vadă rezultatele fără autentificare.
  • Cheia ta are nevoie de scope-urile embed și results_view pentru pacient. Cere de la Aniva scope-ul embed.
  • Apelează-l de pe serverul tău de fiecare dată când pacientul deschide rezultatele. URL-ul funcționează o singură dată și timp de 5 minute, iar apoi pagina menține o sesiune de 60 de minute.
  • route deschide una dintre paginile pe care le punem la dispoziție: lista de biomarkeri, un biomarker sau Twin-ul 3D.
  • appearance setează tema, culoarea butoanelor și a linkurilor și dacă se afișează logo-ul tău.
  • report limitează pagina la o programare, o comandă de kit de testare la domiciliu sau un raport de laborator pe care l-ai încărcat cu POST /api/v1/documents. Pacientul vede atunci doar rezultatele acelui raport.
  • Pagina afișează doar rezultate de laborator, la fel ca acest API. Nu afișează fișiere, chat sau setări.

Exemplu de răspuns cu rezultate