Saltar al contingut principal
GET
Obtén els resultats de laboratori clínics i genètics d’una cita, juntament amb les referències de documents dels PDF d’informes de laboratori. Cada biomarcador sol·licitat per a la cita apareix a la resposta, de manera que pots fer el seguiment de tota la comanda i no només del que ja ha arribat. Llegeix status a cada resultat abans d’utilitzar-ne el value:
  • Les proves encara pendents apareixen amb l’estat planned mentre la cita està en in_progress.
  • Els resultats que el laboratori ha lliurat però que no s’han d’utilitzar clínicament apareixen amb l’estat fault o undeliverable, i inclouen un status_reason que explica per què. Un resultat fault encara té el camp value emplenat — aquest valor és erroni. No el presentis mai com una troballa.
  • Els resultats dels quals Aniva o el membre dubten apareixen amb l’estat likely_wrong i un status_reason. El valor no està confirmat. No el mostris com una troballa sense revisió.
Cada resultat i document rebut inclou el lab_code (codi de barres del tub) amb què s’ha registrat, i la matriu submissions llista cada petició de laboratori de l’extracció de sang amb el seu propi estat — una extracció repartida en diversos tubs o laboratoris es completa petició per petició. Utilitza Descarrega el document per descarregar els PDF d’informes de laboratori referenciats a la matriu documents. No cal que consultis periòdicament aquest endpoint. Subscriu-te als webhooks appointment.results.updated o appointment.results.completed, i crida’l quan arribi un esdeveniment. La consulta periòdica continua funcionant com a alternativa. Requereix l’àmbit results_view.

Sol·licitud

Paràmetres de ruta

string
requerit
Identificador únic (UUID) de la cita de la qual vols obtenir els resultats.

Resposta

En cas d’èxit, l’API retorna 200 OK amb l’objecte dels resultats.
string
requerit
Estat general dels resultats. Un dels següents:
  • in_progress — algunes peticions encara són al laboratori.
  • completed — totes les peticions s’han tancat i almenys una ha emès informe.
  • fault — totes les peticions han fallat sense emetre informe. No queda res pendent.
object[]
requerit
Una entrada per cada petició de laboratori — una extracció de sang que abasta diversos tubs o laboratoris en té diverses. El camp status de nivell superior és completed quan totes les entrades s’han tancat i una ha emès informe.
object[]
requerit
Matriu de resultats de biomarcadors clínics.
object[]
requerit
Matriu de resultats de biomarcadors genètics.
object[]
requerit
Documents d’informes de laboratori. Fes servir GET /api/v1/documents/{id} per descarregar cada fitxer.

Crides repetides

Aniva desa la resposta d’aquest punt final durant 60 minuts per a cada clau d’API. Una crida repetida dins d’aquest període rep la resposta desada mentre la cita i els seus resultats no canviïn. Després d’un canvi, reps una resposta actualitzada. Les capçaleres Cache-Status i Age indiquen que la resposta està desada i quina antiguitat té. Per saber de seguida quan hi ha un canvi, subscriu-te als esdeveniments de webhook appointment.results.updated, appointment.results.completed i appointment.results.fault. Consulta Lectures repetides.

Respostes d’error