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âmpulstatus 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.nullpentru un rezultatplanned.biomarker_nameșicategory— 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.nullpentru un rezultatplannedși pentru rezultatele raportate de laborator fără cod.valueșivalue_operator— măsurătoarea efectivă. Operatorul esteeq(egal) pentru valori exacte sault/gtcâ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ă cavalue. O limită lăsată deschisă de laborator estenull, astfel că un interval unilateral precum< 50ajunge canormal_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 carereference_range_labestenull.nullcând intervalul este prezent și pentru un rezultatplanned. Vezi Când nu există interval de laborator.aniva_range— Valori de comparație compilate de Aniva, pe aceeași scară cavalue. 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ștereference_range_labca standard pentru rezultat.nullcând cheia ta nu are scope-ulaniva_ranges_viewsau 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).nullcând laboratorul nu a atașat niciuna.status_reason— motivul pentru care un rezultatlikely_wrongeste îndoielnic sau un rezultatfaultoriundeliverableeste inutilizabil.nullpentru orice alt status. Distinct decomment, 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 caoriginal 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ă.nullpentru un rezultatplanned.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ă.
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.
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ândreference_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
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.nullpentru un rezultatplanned.gene— simbolul genei.lab_code— codul de laborator (codul de bare al eprubetei) sub care a fost înregistrat rezultatul.nullpentru un rezultatplannedș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.nullcând laboratorul nu a atașat niciuna.status_reason— motivul pentru care un rezultatlikely_wrongeste îndoielnic sau un rezultatfaultoriundeliverableeste inutilizabil.nullpentru 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 arrayvariants. 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 curs_id,allele,reference_alleleși notație HGVS opțională.
Documente
Array-uldocuments 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ătreGET /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_uploadsaupartner_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;nullcâ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
emaila profilului. O adresă provizorie@aniva.emaileste refuzată. - E-mailul afișează numele și logo-ul grupului principal de profiluri al profilului.
- E-mailul este în limba
languagea profilului, implicit engleză. - Setează
with_reportslatruepentru a atașa rapoartele de laborator. - Adaugă
notepentru a afișa o notă personală în e-mail, de cel mult 1.000 de caractere.
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_emailsle 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_viewla 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șiresults_viewpentru pacient. Cere de la Aniva scope-ulembed. - 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.
routedeschide una dintre paginile pe care le punem la dispoziție: lista de biomarkeri, un biomarker sau Twin-ul 3D.appearancesetează tema, culoarea butoanelor și a linkurilor și dacă se afișează logo-ul tău.reportlimitează pagina la o programare, o comandă de kit de testare la domiciliu sau un raport de laborator pe care l-ai încărcat cuPOST /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.