Saltar al contenido principal
La API de socios de Aniva es una API REST que permite a los socios sanitarios gestionar perfiles de pacientes, programar citas de extracción de sangre en ubicaciones de análisis y activar los flujos de órdenes de laboratorio. Interactúas con la API por HTTPS con tu clave API de socio.

Qué puedes hacer

  • Gestión de perfiles — Crear, consultar y actualizar perfiles demográficos de pacientes.
  • Programación de citas — Reservar citas de extracción de sangre en las ubicaciones de análisis de Aniva.
  • Gestión de paneles — Añadir o quitar paneles de análisis de laboratorio en una cita existente.
  • Biomarcadores individuales — Vincular o desvincular biomarcadores individuales en una cita sin elegir un panel.
  • Pedidos de kits de prueba en casa — Enviar un kit de prueba en casa por correo a un paciente, seguir sus paquetes e informar cuándo se recogió la muestra.
  • Catálogo de paneles — Consultar los paneles disponibles con GET /api/v1/panels para obtener los ID de los paneles y los biomarcadores que incluye cada uno.
  • Catálogo de biomarcadores — Consultar los biomarcadores que puedes pedir en una ubicación o en un kit de prueba en casa con GET /api/v1/biomarkers para obtener sus ID.
  • Confirmación de extracción de sangre — Enviar el código o los códigos de laboratorio tras una extracción de sangre para activar el flujo de órdenes de laboratorio.
  • Resultados de laboratorio — Obtener resultados clínicos y genéticos y descargar informes de laboratorio en PDF.
  • Búsqueda de ubicaciones — Listar las ubicaciones de análisis disponibles para mostrárselas a los pacientes.
  • Logística de envíos — Crear, seguir, modificar y cancelar pedidos de envío por mensajería.
  • Webhooks — Recibir una llamada HTTPS cuando cambia una cita, un pedido de kit de prueba en casa, sus resultados, una ubicación, un perfil o un envío. Consulta Webhooks.

Explora la documentación

Autenticación

Autentica las solicitudes con tu clave API de socio.

Inicio rápido

Haz tu primera llamada a la API en minutos con ejemplos paso a paso.

Perfiles

Descubre cómo funcionan los perfiles de pacientes y qué datos almacenan.

Citas

Entiende el ciclo de vida de una cita, desde la programación hasta la confirmación.

Pedidos de kits de prueba en casa

Envía un kit de prueba al domicilio de un paciente y síguelo hasta que la muestra llegue al laboratorio.

Versionado de la API

La versión actual de la API es v1. Todos los endpoints llevan el prefijo /api/v1/. La URL base es https://anivahealth.com.
Los cambios incompatibles se introducirán bajo un nuevo prefijo de versión. La API v1 seguirá disponible y cualquier retirada se avisará con antelación.

Fechas y zonas horarias

Todos los instantes transmitidos están en UTC ISO 8601 (sufijo Z). Los campos solo de calendario usan componentes de reloj local (YYYY-MM-DD, HH:MM). Notas específicas:
  • Las entradas que aceptan una fecha y hora (p. ej. scheduled_at en POST / PATCH /api/v1/appointments) deben incluir un indicador de zona horaria, ya sea Z o un desplazamiento explícito como +02:00. Las fechas y horas sin zona horaria se rechazan con 400. Ambas formas codifican el mismo instante; la respuesta siempre devuelve scheduled_at en UTC Z. Usa el campo timezone de la ubicación (o cualquier otro identificador IANA) para formatear el instante en hora local al mostrarlo.
  • Las entradas de reloj local se interpretan en la zona horaria del recurso al que apuntan: las fechas de disponibilidad usan el parámetro de consulta timezone (por defecto, la zona horaria de la ubicación); pickup_date / pickup_time_* del envío se interpretan en la zona horaria de la ubicación de origen.
  • Los campos de respuesta solo de fecha (p. ej. tested_at, availability[].date de disponibilidad) son fechas de calendario sin zona horaria.

Obtener acceso

Aniva emite las claves API por socio.
Contacta con Aniva para recibir tu clave API de socio.