Una sola clave API te da 45 endpoints, desde la reserva hasta los resultados de laboratorio
La API para socios de Aniva reserva una extracción de sangre en más de 25 centros de Alemania, añade paneles a esa cita y devuelve resultados clínicos y genéticos en JSON. Cada solicitud necesita una cabecera y la URL base es la misma en todos los entornos.
Cuándo usar Aniva
Hoy hay 45 endpoints documentados y activos
La autenticación solo necesita una cabecera de solicitud
Todas las rutas empiezan con el prefijo v1
Los centros en Alemania pueden hacer la extracción de sangre
Cuatro solicitudes van desde la reserva hasta los resultados de laboratorio
Cada solicitud devuelve el ID que necesita la siguiente, así que una integración básica son cuatro solicitudes antes de añadir paneles, cambios de cita o mensajería.
Listas las ubicaciones en las que tu clave puede reservar
La respuesta te da cada dirección, el horario de apertura y la zona horaria, para que un cliente solo vea franjas horarias que existen.
Creas un perfil para el cliente
Un perfil necesita un nombre, un código de sexo, una fecha de nacimiento y tu profile_group, que acepta un UUID o tu propio slug.
Reservas la cita en la franja que elijas
La reserva necesita el ID del perfil, el ID de la ubicación y una fecha y hora en formato ISO 8601 con su desplazamiento horario o el sufijo Z.
Confirmas la extracción con el código de barras del kit
Esta solicitud inicia el pedido de laboratorio y bloquea la cita, así que modifica todos los paneles antes de enviarla.
Cada grupo de recursos es una colección REST
Puedes pedir una extracción de sangre en una clínica o un kit de prueba en casa por correo. Ambos llegan en el mismo formato, así que solo escribes una vez el código que lee los resultados.
Un perfil es la persona a la que haces el análisis
Buscas un perfil por correo electrónico, lo creas en tu grupo de perfiles y actualizas los datos demográficos más adelante.
Una cita incluye los paneles y la extracción de sangre
Quince endpoints cubren la reserva y cualquier cambio posterior, incluidos los paneles, las vistas previas de los recipientes y la confirmación.
Los pedidos de kit de prueba en casa son la versión por correo
Diez endpoints solicitan un kit de prueba en casa para un perfil, cambian sus paneles y devuelven la misma estructura de resultados.
Las ubicaciones te indican dónde se hace una extracción de sangre
Consultas las ubicaciones en las que tu clave puede reservar y luego pides a una de ellas los inicios de franja disponibles.
Los resultados llegan en filas clínicas y genéticas
Cada tipo de pedido tiene su propia llamada de resultados, y el informe en PDF se descarga por separado mediante el ID de archivo.
Un mensajero lleva la muestra al laboratorio
Creas un pedido de mensajería con una franja de recogida en día laborable, luego asocias las citas y consultas sus actualizaciones de estado.
Los catálogos enumeran los biomarcadores que puedes solicitar
Los catálogos de biomarcadores, paneles y unidades están paginados, y puedes filtrar los biomarcadores por ubicación de la prueba.
Un endpoint de disponibilidad no necesita clave API
La sonda de preparación no necesita clave API, así que tu monitor de disponibilidad puede consultarla de forma programada.
El proceso de laboratorio empieza cuando confirmas la extracción de sangre
Nos envías el código de barras del kit y eso es lo último que necesitamos de ti. Después organizamos los recipientes, la mensajería y el laboratorio, así que tu código solo llama a dos endpoints hasta que el informe está listo.
Cada resultado tiene dos intervalos de referencia y cuatro estados
Cada fila clínica incluye el intervalo informado por el laboratorio y el intervalo de Aniva con su franja óptima, para que puedas mostrar ambos sin mantener tu propia tabla de consulta.
Las fechas y horas necesitan una zona horaria o la solicitud falla
Una fecha y hora sin zona horaria se rechaza con 400, que es el error que cometen la mayoría de las primeras integraciones.
Cada solicitud necesita tu clave API de colaborador
La autenticación usa la cabecera x-api-key en cada llamada, y una clave ausente o rotada devuelve 403 con un breve error JSON.
Puedes ver cada servicio en la página de estado
La página de estado muestra la situación actual y un historial de 90 días de cada servicio, y los mismos datos están disponibles en formato JSON para tu propia monitorización.
Pedirnos hoy una clave de socio
Dinos en qué mercados vendes y qué paneles necesitas, y te enviaremos una clave con los permisos adecuados.
Esta página es un prototipo de diseño. Todos los endpoints y payloads que aparecen provienen de docs.anivahealth.com, y el diagrama del pipeline es ilustrativo.
Las copias legibles por máquina de la documentación están en docs.anivahealth.com/llms.txt y docs.anivahealth.com/llms-full.txt.