Saltar al contenido principal
GET
Obtén los resultados clínicos y genéticos de laboratorio de una cita, junto con las referencias a los documentos PDF de los informes de laboratorio. Todos los biomarcadores solicitados para la cita aparecen en la respuesta, para que puedas seguir el pedido completo y no solo lo que ya ha llegado. Lee status en cada resultado antes de usar su value:
  • Las pruebas todavía pendientes aparecen con el estado planned mientras la cita está en in_progress.
  • Los resultados que el laboratorio ha entregado pero que no deben usarse clínicamente aparecen con el estado fault o undeliverable, e incluyen un status_reason que explica por qué. Un resultado fault sigue teniendo su value relleno — ese valor es incorrecto. Nunca lo presentes como un hallazgo.
  • Los resultados de los que Aniva o el miembro dudan aparecen con el estado likely_wrong y un status_reason. El valor no está confirmado. No lo muestres como un hallazgo sin revisarlo.
Cada resultado y documento recibido incluye el lab_code (código de barras del tubo) con el que se registró, y el array submissions enumera cada petición de laboratorio de la extracción de sangre con su propio estado — una extracción repartida en varios tubos o laboratorios se completa petición a petición. Usa Descargar documento para descargar los PDF de los informes de laboratorio referenciados en el array documents. No necesitas consultar este endpoint periódicamente. Suscríbete a los webhooks appointment.results.updated o appointment.results.completed y llámalo cuando llegue un evento. Las consultas periódicas siguen funcionando como alternativa. Requiere el scope results_view.

Solicitud

Parámetros de ruta

string
requerido
Identificador único (UUID) de la cita de la que quieres obtener los resultados.

Respuesta

Si la solicitud tiene éxito, la API devuelve 200 OK con el objeto de resultados.
string
requerido
Estado general de los resultados. Uno de los siguientes:
  • in_progress — algunas peticiones siguen en el laboratorio.
  • completed — todas las peticiones se han cerrado y al menos una ha emitido informe.
  • fault — todas las peticiones fallaron sin emitir informe. No queda nada pendiente.
object[]
requerido
Una entrada por cada petición de laboratorio — una extracción de sangre repartida en varios tubos o laboratorios tiene varias. El status de nivel superior es completed cuando todas las entradas se han cerrado y una ha emitido informe.
object[]
requerido
Array de resultados de biomarcadores clínicos.
object[]
requerido
Array de resultados de biomarcadores genéticos.
object[]
requerido
Documentos del informe de laboratorio. Usa GET /api/v1/documents/{id} para descargar cada archivo.

Llamadas repetidas

Aniva almacena la respuesta de este endpoint durante 60 minutos para cada clave de API. Una llamada repetida dentro de este plazo obtiene la respuesta almacenada mientras la cita y sus resultados no cambien. Tras un cambio, obtienes una respuesta nueva. Las cabeceras Cache-Status y Age indican que la respuesta está almacenada y cuál es su antigüedad. Para enterarte de un cambio al instante, suscríbete a los eventos de webhook appointment.results.updated, appointment.results.completed y appointment.results.fault. Consulta Lecturas repetidas.

Respuestas de error