Reserva anàlisis de sang des del teu propi producte

Una clau d'API et dona 45 endpoints, des de la reserva fins als resultats de laboratori

L'Aniva Partner API reserva una extracció de sang en més de 25 ubicacions a Alemanya, afegeix panells a aquesta cita i retorna resultats clínics i genètics en format JSON. Cada sol·licitud necessita una capçalera, i l'URL base és el mateix en tots els entorns.

Quan fer servir Aniva

Fes servir Aniva quan els teus clients necessitin reservar una anàlisi de sang
Fes servir els endpoints de cita per a una extracció de sang a la clínica i els endpoints de kit de prova a casa per a un kit per correu postal.
Fes servir els endpoints de resultats per a les files clíniques, les files genètiques i l'informe en PDF.
Utilitza els endpoints del catàleg per llegir els biomarcadors, els panells i les unitats que ven Aniva.
Utilitza les rutes documentades sota https://anivahealth.com/api/v1/ i no inventis endpoints.
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
El flux bàsic són quatre peticions
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 punts finals estan documentats i actius avui

1

L'autenticació només necessita una capçalera de sol·licitud

v1

Cada ruta comença amb el prefix v1

25+

Els centres d'Alemanya poden fer l'extracció de sang

Quatre peticions creen una integració funcional

Quatre sol·licituds van de la reserva als resultats de laboratori

Cada sol·licitud retorna l'ID que necessita la següent, així que una integració bàsica són quatre sol·licituds abans d'afegir-hi panells, canvis de cita o missatgers.

Pas 01 · GET /locations

Llistes les ubicacions on pot reservar la teva clau

La resposta et dona cada adreça, l'horari d'obertura i la zona horària, així un client només veu les franges que existeixen.

Proves
Pas 02 · POST /profiles

Crees un perfil per al client

Un perfil necessita un nom, un codi de sexe, una data de naixement i el teu profile_group, que accepta un UUID o el teu propi slug.

Proves
Pas 03 · POST /appointments

Reserves la cita a la franja que triïs

La reserva necessita l'ID del perfil, l'ID de la ubicació i una data i hora ISO 8601 amb el seu desplaçament horari o el sufix Z.

Proves
Pas 04 · POST /appointments/{id}/confirm

Confirmes l'extracció de sang amb el codi de barres del kit

Aquesta sol·licitud inicia la comanda al laboratori i bloqueja la cita, així que modifica cada panell abans d'enviar-la.

Proves
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
Capacitat

Cada grup de recursos és una col·lecció REST

Pots demanar una extracció de sang en una clínica o un kit de prova a casa per correu postal. Tots dos tornen en el mateix format, així que només escrius una vegada el codi que llegeix els resultats.

Perfils · 4 endpoints

Un perfil és la persona a qui fas l'anàlisi

Busques un perfil per correu electrònic, el crees dins del teu grup de perfils i actualitzes les dades demogràfiques més endavant.

Proves
GET /profiles
PATCH /profiles/{id}
Cites · 15 endpoints

Una cita inclou els panells i l'extracció de sang

Quinze punts finals cobreixen la reserva i cada canvi posterior, inclosos els panells, les previsualitzacions dels recipients i la confirmació.

Proves
POST /appointments
GET /appointments/{id}/results
Comandes de kits de prova a casa · 10 endpoints

Les comandes de kits de prova a casa són la versió per correu

Deu endpoints sol·liciten un kit DIY per a un perfil, en canvien els panells i retornen la mateixa estructura de resultats.

Proves
Crea una comanda de kit
Obtén els resultats
Ubicacions · 2 punts finals

Les ubicacions t'indiquen on es fa una extracció de sang

Llegeixes les ubicacions que la teva clau pot reservar i després demanes a una d'elles els inicis de franja disponibles.

Proves
GET /locations
GET /locations/{id}/availability
Documents · 1 punt final

Els resultats arriben en files clíniques i genètiques

Cada tipus de comanda té la seva pròpia crida de resultats, i l'informe en PDF és una descàrrega separada per ID de fitxer.

Proves
GET /appointments/{id}/results
GET /documents/{id}
Enviaments · 8 endpoints

Un missatger porta la mostra al laboratori

Crees una ordre de missatgeria amb una franja de recollida entre setmana, hi adjuntes les cites i en consultes les actualitzacions d'estat.

Proves
POST /shipments
Adjunta cites
Catàlegs · 4 punts d'accés

Els catàlegs recullen els biomarcadors que pots demanar

Els catàlegs de biomarcadors, panells i unitats estan paginats, i pots filtrar els biomarcadors per ubicació de la prova.

Proves
GET /biomarkers
GET /panels
Salut · 1 endpoint

Un punt final de disponibilitat no necessita clau d'API

La sonda de disponibilitat no necessita cap clau d'API, així que el teu monitor de temps d'activitat pot cridar-la de manera programada.

Proves
Sonda de disponibilitat pública
La teva feina acaba amb la confirmació del codi de barres

El procés de laboratori comença quan confirmes l'extracció de sang

Ens envies el codi de barres del kit, i això és l'últim que necessitem de tu. Després organitzem els recipients, la missatgeria i el laboratori, de manera que el teu codi només crida dos endpoints fins que l'informe estigui a punt.

The Aniva lab pipeline from confirmation to results Confirming the draw is followed by container selection, courier collection and laboratory analysis, and each biomarker row then reads as planned, received or fault. POST /appointments/{id}/confirmYou confirm the draw GET /appointments/{id}/previewContainers are known POST /shipmentsA courier collects it Aniva laboratory networkThe laboratory analyses planned received fault GET /appointments/{id}/results
Un punt ple és la ruta que vols.Un anell és un estat que encara gestiones.Les línies taronges són la comanda confirmada.
Un mateix analitzador llegeix una extracció de sang en clínica i un kit de prova a casa

Cada resultat té dos intervals de referència i quatre estats

Cada fila clínica inclou l'interval informat pel laboratori i l'interval d'Aniva amb la seva franja òptima, perquè els puguis mostrar tots dos sense mantenir la teva pròpia taula de consulta.

Una fila indica planificat abans que el laboratori l'analitzi.
Una fila mostra rebut un cop arriben un valor i una unitat.
Una fila mostra fault quan el laboratori ha cancel·lat la sol·licitud, i status_reason n'explica el motiu.
GET /api/v1/appointments/{id}/results
{
  "status": "in_progress",
  "clinical_results": [{
    "status": "received",
    "biomarker_name": "Vitamin D",
    "value": 38.5, "unit": "ng/mL",
    "reference_range_lab": { "normal_min": 30, "normal_max": 100 },
    "reference_range_aniva": { "optimal_min": 40, "optimal_max": 60 },
    "tested_at": "2026-04-05"
  }],
  "documents": [{ "file_name": "lab-report-2026-04-05.pdf" }]
}
L'API utilitza tres formats de temps

Les dates i hores necessiten una zona horària o la sol·licitud falla

Una data i hora sense zona horària es rebutja amb un 400, que és l'error més comú en la majoria de les primeres integracions.

Les marques de temps sempre es retornen en UTC, fent servir ISO 8601 amb el sufix Z.
Les entrades han d'incloure un desplaçament horari explícit, de manera que una reserva accepta 2026-05-15T12:30:00+02:00.
Les actualitzacions d'enviament mantenen el desfasament informat pel proveïdor logístic.
Els camps de calendari són només d'hora local, com ara una data de naixement.
Aniva emet i rota cada clau de soci

Cada sol·licitud necessita la teva clau API de col·laborador

L'autenticació fa servir la capçalera x-api-key a cada crida, i una clau que falta o ha estat rotada retorna un 403 amb un breu error JSON.

La teva clau decideix quines ubicacions, cites i enviaments pots veure.
No exposis mai la teva clau d'API en codi del costat del client ni en repositoris públics.
Una sonda pública no necessita cap clau d'API

Pots seguir cada servei a la pàgina d'estat

La pàgina d'estat mostra l'estat actual i un historial de 90 dies per a cada servei, i les mateixes dades estan disponibles en JSON per al teu propi monitor.

Les claus de col·laborador les emet el nostre equip

Demana'ns una clau de col·laborador avui

Digue'ns en quins mercats vens i quins panells necessites, i t'enviarem una clau amb els permisos adequats.

També pots descarregar el fitxer OpenAPI

Aquesta pàgina és una maqueta de disseny. Cada endpoint i payload que hi apareix s'ha tret de docs.anivahealth.com, i el diagrama del flux és il·lustratiu.

Hi ha còpies de la documentació llegibles per màquines a docs.anivahealth.com/llms.txt i docs.anivahealth.com/llms-full.txt.