GET /api/v1/appointments/{id}/results i inclouen resultats de biomarcadors clínics, resultats de biomarcadors genètics i documents d’informe de laboratori descarregables.
Estat dels resultats
El campstatus de nivell superior de la resposta dels resultats indica el progrés general del processament:
Els resultats individuals dins de la resposta tenen el seu propi estat per resultat (consulta més avall), de manera que pots mostrar resultats parcials mentre l’estat general encara és
in_progress.
Per saber quan canvien els resultats, subscriu-te als webhooks. appointment.results.updated s’activa amb cada canvi del cos dels resultats, i appointment.results.completed s’activa quan l’estat de nivell superior passa a completed. Les comandes de kits de prova a casa envien els mateixos esdeveniments amb el prefix home_kit_order.. Cada esdeveniment inclou l’URL dels resultats per consultar-lo. Pots continuar fent consultes periòdiques a aquest endpoint per reconciliar les dades.
La matriu submissions desglossa l’estat de nivell superior per petició de laboratori. Una extracció de sang que inclou diversos tubs o diversos laboratoris té diverses entrades, cadascuna amb el lab_code (codi de barres del tub) amb què es va registrar i el seu propi estat in_progress / completed / fault. Una entrada fault ha estat rebutjada o abandonada al laboratori i no emetrà mai resultats: sovint la mostra s’ha traslladat a un altre laboratori, que aleshores registra la seva pròpia entrada. L’estat de nivell superior és completed quan totes les entrades s’han tancat i almenys una ha emès resultats. Cada resultat rebut i cada document porta el mateix lab_code, així que pots saber de quin tub prové un valor.
Resultats clínics
Els resultats clínics representen mesures estàndard de biomarcadors en sang, com ara els nivells de vitamina D, el colesterol, les hormones tiroidals, etc. Cada resultat clínic inclou:id— l’identificador de fila del resultat de laboratori. Es manté igual quan el laboratori corregeix aquesta fila, així que fes-lo servir per fer un upsert.nullper a un resultatplanned.biomarker_nameicategory— què s’ha mesurat i la seva agrupació (p. ex., vitamines, hormones).lab_code— el codi de laboratori (codi de barres del tub) amb què es va registrar el resultat, un dels codis de laboratori de la comanda.nullper a un resultatplannedi per als resultats que el laboratori ha informat sense codi.valueivalue_operator— la mesura efectiva. L’operador éseq(igual) per a valors exactes, olt/gtquan el laboratori informa un valor per sota o per sobre de l’interval mesurable.unit— la unitat de mesura (p. ex., ng/mL, µIU/mL).reference_range_lab— els límits mínim i màxim normals i òptims informats pel laboratori per a aquest resultat, convertits a la mateixa escala quevalue. Un límit que el laboratori deixa obert ésnull, de manera que un interval unilateral com< 50arriba comnormal_min: null, normal_max: 50. Cada resultat porta l’interval amb què es va mesurar, així que un pacient amb resultats de diverses extraccions de sang o laboratoris rep l’interval adequat per a cada resultat.reference_range_lab_absent_reason— per quèreference_range_labésnull.nullquan hi ha interval, i en un resultatplanned. Consulta Quan no hi ha interval de laboratori.aniva_range— Valors de comparació recopilats per Aniva, a la mateixa escala quevalue. Varien segons l’edat, el sexe i la setmana d’embaràs.normal_*és l’interval general.optimal_*és un interval més estret. Els valors són només informatius. No són consell mèdic, ni un diagnòstic ni una valoració del resultat. Aniva no hi assigna cap indicador. Fes servirreference_range_labcom a estàndard per al resultat.nullquan la teva clau no té l’àmbitaniva_ranges_viewo quan Aniva no té valors per a aquest biomarcador.tested_at— la data en què es va fer la prova.comment— anotació de text lliure del laboratori sobre aquest resultat concret (p. ex., orientació sobre l’interval de referència, avisos sobre la qualitat de la mostra).nullquan el laboratori no n’ha adjuntat cap.status_reason— per què un resultatlikely_wrongés dubtós, o per què un resultatfaultoundeliverableno és utilitzable.nullper a qualsevol altre estat. És diferent decomment, que és la nota pròpia del laboratori i sovint és buida en els resultats amb error.origin— qui ha lliurat el document d’on prové el valor, amb els mateixos valors que l’origindel document més avall. Un valor d’un document pujat (member_upload,staff_upload,partner_upload) prové de la lectura que fa Aniva del fitxer, no d’un informe de laboratori: comprova’l amb el fitxer abans de fer-ne un ús clínic.nullper a un resultatplanned.lab_reported— la línia pròpia de l’informe del laboratori que ha fet l’anàlisi, literal i sense convertir. Consulta més avall.
Intervals d’Aniva
aniva_range conté valors de comparació que Aniva ha recopilat a partir de fonts publicades i
de la seva pròpia selecció. Els intervals varien segons l’edat, el sexe i la setmana d’embaràs.
sources enumera les fonts publicades que Aniva ha registrat per als valors. La llista pot estar buida.
Normes per al teu producte:
- Mostra l’interval d’Aniva només com a complement de l’interval del laboratori, mai en el seu lloc.
- Si derives un indicador, un avís o una recomanació de l’interval d’Aniva, ho fas en nom propi i sota la teva pròpia responsabilitat.
- Mostra l’avís del teu acord amb Aniva allà on mostris l’interval d’Aniva.
aniva_ranges_view a la teva clau. Els valors poden canviar sense avís previ.
Valors normalitzats enfront de la línia pròpia del laboratori
value, unit i reference_range_lab estan normalitzats: convertim cada mesura a la unitat canònica del biomarcador i l’informem amb el nostre propi nom de biomarcador, de manera que el mateix analit és comparable entre laboratoris i al llarg del temps. Això és el que vols per seguir tendències i comparar entre laboratoris, i no és el que veu un metge quan revisa el PDF del laboratori: una fosfatasa alcalina impresa com 48 U/l (40 - 129) t’arriba com 0.8 µkat/L.
lab_reported inclou aquesta línia impresa al costat: el nom i el codi de l’analit del laboratori, el valor i la unitat tal com s’han imprès, l’interval de referència tant en format de text (< 50, > 55, 40 - 129) com amb els límits propis del laboratori sense convertir, a més del seu indicador d’anormalitat, l’estat del resultat i la nota.
Fes servir lab_reported quan una persona estigui reconciliant les teves dades amb l’informe del laboratori, i els camps canònics per a tot el que sigui calculat. Només s’emplenen els camps que el laboratori ha enviat realment; a lab_reported no s’infereix, no s’assigna per defecte ni es converteix res, i tot l’objecte és null quan no tenim cap registre en brut per a un resultat.
Quan no hi ha interval de laboratori
Quanreference_range_lab és null, reference_range_lab_absent_reason t’indica per què:
Alguns laboratoris imprimeixen un objectiu o un nivell de risc en lloc d’un interval de referència, per exemple
Ziel: <200. >240 hoch o <5.7 neg >=6.5 pos. Aquests valors no van a reference_range_lab, així que els seus
límits són null i el motiu és lab_text_only. Mostra el text imprès literalment.
Un interval unilateral com < 20 és un interval. Arriba a reference_range_lab amb un límit
null, i el motiu és null. Mantén obert l’extrem obert quan el mostris.
Estats dels resultats clínics
Resultats genètics
Els resultats genètics representen troballes a nivell de gen a partir d’una anàlisi d’ADN. Cada resultat correspon a un gen (p. ex., APOE, MTHFR) i inclou:id— l’identificador de fila del resultat de laboratori. Es manté igual quan el laboratori corregeix aquesta fila, així que fes-lo servir per fer un upsert.nullper a un resultatplanned.gene— el símbol del gen.lab_code— el codi de laboratori (codi de barres del tub) amb què es va registrar el resultat.nullper a un resultatplannedi per als resultats que el laboratori ha informat sense codi.genotype— el genotip detectat (p. ex., E3/E4).clinical_significance— una classificació de la troballa basada en l’ACMG.risk_description— una explicació llegible per a persones del que significa el genotip.comment— anotació de text lliure del laboratori sobre aquest resultat concret.nullquan el laboratori no n’ha adjuntat cap.status_reason— per què un resultatlikely_wrongés dubtós, o per què un resultatfaultoundeliverableno és utilitzable.nullper a qualsevol altre estat.origin— qui ha lliurat el document d’on prové el valor, igual que als resultats clínics.variants— les variants genètiques específiques detectades, cadascuna amb detall a nivell d’SNV.
Valors de significació clínica
Estats dels resultats genètics
Estructura de les variants
Cada resultat genètic conté una matriuvariants. Cada variant inclou:
name— nom comú (p. ex., APOE E4).clinical_significance— significat a nivell de variant (pot diferir del significat a nivell de gen).conditions— malalties o afeccions associades amb descripcions.snvs— les variants d’un sol nucleòtid subjacents, cadascuna ambrs_id,allele,reference_allelei notació HGVS opcional.
Documents
La matriudocuments de la resposta dels resultats conté referències a fitxers d’informes de laboratori descarregables. Cada document té:
id— un UUID de fitxer. Passa’l aGET /api/v1/documents/{id}per descarregar el fitxer.file_name— el nom del fitxer, el mateix que envia la descàrrega (p. ex.,20260405 - Quade Befund - 7642001234.pdf).original_file_name— el nom del fitxer exactament tal com el va lliurar el laboratori o qui el va pujar (p. ex.,7642001234_B0012_FA_E.pdf).origin— qui ha lliurat el fitxer:lab,member_upload,staff_uploadopartner_upload(el vas pujar amb Pujar un document).content_type— el tipus de medi del fitxer (p. ex.,application/pdf). La majoria d’informes són PDF. Els escanejos pujats poden ser imatges o fitxers CSV.etag— la versió del contingut del fitxer; canvia cada vegada que canvien els bytes. Desa’l i torna a descarregar el fitxer només quan canviï. És l’etiqueta d’entitat HTTP estàndard, com la que fan servir S3 o Google Cloud Storage.size_bytes— la mida del fitxer en bytes.lab_code— el codi de laboratori (codi de barres del tub) al qual pertany l’informe;nullquan el laboratori no n’ha registrat cap.
L’accés als documents es valida segons el perfil propietari del document.
Enviar els resultats per correu al client
Pots avisar el client per correu electrònic que els seus resultats estan a punt. Crida Enviar resultats per correu per a una cita, o Enviar resultats per correu per a una comanda de kit de prova a casa. Cada crida envia un correu. Les crides no es dedupliquen.- El correu electrònic s’envia a l’
emaildel perfil. Una adreça@aniva.emailprovisional es rebutja. - El correu electrònic mostra el nom i el logotip del grup de perfils principal del perfil.
- El correu electrònic és en el
languagedel perfil, en anglès per defecte. - Defineix
with_reportscom atrueper adjuntar els informes de laboratori. - Afegeix
noteper mostrar una nota personal al correu electrònic, de com a màxim 1.000 caràcters.
409 amb el motiu
unsubscribed. Per tornar-los a activar, defineix transactional_emails_enabled com a true amb
Actualitzar el perfil.
Correus d’avís de resultats a punt
Pots rebre un correu electrònic quan els resultats d’una reserva estiguin a punt. Defineixresults_ready_emails amb fins a 5
adreces a Crear una cita o
Crear una comanda de kit de prova a casa. Canvia la llista més endavant amb
Actualitzar una cita o
Actualitzar una comanda de kit de prova a casa; [] desactiva els correus.
- Demana’ns que configurem adreces de correu predeterminades per al teu grup de perfils. Una reserva creada sense
results_ready_emailsles rep. Una llista les substitueix per a aquella reserva, així que inclou la teva adreça de correu predeterminada per mantenir-la.[]no envia cap correu. - Cada adreça rep un sol correu un cop tots els resultats de laboratori de la reserva són definitius.
- Una adreça afegida després que els resultats siguin definitius rep el correu de seguida.
- El correu enllaça a la pàgina de resultats del panell d’administració d’Aniva. El client no el rep.
- La teva clau necessita accés
results_viewal pacient. Sense aquest accés, la sol·licitud retorna403.
Mostra els resultats a la teva aplicació
Crear una sessió incrustada retorna un URL d’un sol ús per a una pàgina de resultats només de lectura. Obre’l en un WebView de la teva aplicació perquè el pacient vegi els resultats sense iniciar sessió.- La teva clau necessita els àmbits
embediresults_viewper al pacient. Demana a Aniva l’àmbitembed. - Fes la crida des del teu servidor cada vegada que el pacient obri els resultats. L’URL funciona una sola vegada i durant 5 minuts, i després la pàgina manté una sessió de 60 minuts.
routeobre una de les pàgines que publiquem: la llista de biomarcadors, un biomarcador o el Twin 3D.appearancedefineix el tema, el color dels botons i dels enllaços, i si es mostra el teu logotip.reportlimita la pàgina a una cita, una comanda de kit de prova a casa o un informe de laboratori que hagis pujat ambPOST /api/v1/documents. Aleshores el pacient només veu els resultats d’aquell informe.- La pàgina mostra només els resultats de laboratori, igual que aquesta API. No mostra cap fitxer, cap xat ni cap configuració.