Saltar al contenido principal
GET
Obtén los resultados de laboratorio clínicos y genéticos de un pedido de kit de prueba en casa, junto con las referencias de los documentos de los informes de laboratorio en PDF. Todos los biomarcadores solicitados para el kit aparecen en la respuesta, para que puedas seguir el pedido completo y no solo lo que ya ha llegado. Los resultados se registran bajo el lab_code del pedido — el pedido al laboratorio se realiza en la activación y el laboratorio informa los marcadores de uno en uno a medida que se analizan, por lo que es normal recibir una respuesta parcial y el status principal permanece en in_progress hasta el informe final. Lee el status de cada resultado antes de usar su value:
  • Las pruebas aún pendientes aparecen con el estado planned mientras el pedido está en in_progress. Puedes llamar a este endpoint antes de la activación — todos los marcadores solicitados aparecen entonces como planned.
  • Los resultados entregados por el laboratorio que no deben usarse clínicamente aparecen con el estado fault o undeliverable, e incluyen un status_reason que explica el motivo. Un resultado fault sigue teniendo su value relleno — ese valor es erróneo. Nunca lo muestres como un hallazgo.
  • Los resultados de los que dudan Aniva o el miembro aparecen con el estado likely_wrong y un status_reason. El valor no está confirmado. No lo muestres como un hallazgo sin revisión.
Usa Descargar documento para descargar los PDF de los informes de laboratorio referenciados en el array documents. No hace falta que consultes este endpoint de forma periódica. Suscríbete a los webhooks home_kit_order.results.updated o home_kit_order.results.completed y llámalo cuando llegue un evento. Las consultas periódicas siguen funcionando como alternativa. Requiere el ámbito results_view — los resultados de laboratorio y los documentos siempre están protegidos por él, igual que los resultados de una cita y Descargar documento — más el ámbito home_kit_orders_view o home_kit_orders_manage para acceder al propio pedido del kit.

Solicitud

Parámetros de ruta

string
requerido
Identificador único (UUID) del pedido de kit de prueba en casa del 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 guarda la respuesta de este endpoint durante 60 minutos para cada clave de API. Una llamada repetida dentro de este plazo recibe la respuesta guardada mientras el pedido de kit de prueba en casa y sus resultados no cambien. Tras un cambio, recibes una respuesta nueva. Las cabeceras Cache-Status y Age muestran que la respuesta está guardada y su antigüedad. Para enterarte de un cambio al instante, suscríbete a los eventos de webhook home_kit_order.results.updated, home_kit_order.results.completed y home_kit_order.results.fault. Consulta Lecturas repetidas.

Respuestas de error