Prenota esami del sangue dall'interno del tuo prodotto

Una chiave API ti offre 45 endpoint, dalla prenotazione ai risultati di laboratorio

L'Aniva Partner API prenota un prelievo di sangue in oltre 25 sedi in Germania, aggiunge pannelli a quell'appuntamento e restituisce i risultati clinici e genetici in formato JSON. Ogni richiesta necessita di un solo header e l'URL di base è lo stesso in ogni ambiente.

Quando usare Aniva

Usa Aniva quando i tuoi clienti hanno bisogno di prenotare un esame del sangue
Usa gli endpoint per gli appuntamenti per un prelievo di sangue in clinica e gli endpoint per il kit domiciliare per un kit via posta.
Usa gli endpoint dei risultati per le righe cliniche, le righe genetiche e il referto in PDF.
Usa gli endpoint del catalogo per leggere i biomarcatori, i pannelli e le unità venduti da Aniva.
Usa i percorsi documentati sotto https://anivahealth.com/api/v1/ e non inventare endpoint.
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"
  }'
Il flusso di base prevede quattro richieste
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 endpoint sono documentati e attivi oggi

1

L'autenticazione richiede un solo header di richiesta

v1

Ogni percorso inizia con il prefisso v1

25+

Le sedi in Germania possono fare il prelievo di sangue

Quattro richieste creano un'integrazione funzionante

Quattro richieste portano dalla prenotazione ai risultati di laboratorio

Ogni richiesta restituisce l'ID di cui ha bisogno la successiva, quindi un'integrazione di base richiede quattro richieste prima di aggiungere pannelli, riprogrammazioni o corrieri.

Passaggio 01 · GET /locations

Elenchi le sedi che la tua chiave può prenotare

La risposta ti fornisce ogni indirizzo, gli orari di apertura e il fuso orario, così un cliente vede solo gli slot che esistono.

Esami
Passaggio 02 · POST /profiles

Crei un profilo per il cliente

Un profilo richiede un nome, un codice sesso, una data di nascita e il tuo profile_group, che accetta un UUID o il tuo slug.

Esami
Passo 03 · POST /appointments

Prenoti l'appuntamento nella fascia oraria scelta

La prenotazione richiede l'ID profilo, l'ID sede e una data e ora ISO 8601 con il relativo offset o il suffisso Z.

Esami
Passaggio 04 · POST /appointments/{id}/confirm

Confermi il prelievo con il codice a barre del kit

Questa richiesta avvia l'ordine di laboratorio e blocca l'appuntamento, quindi modifica ogni pannello prima di inviarla.

Esami
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"
  }'
Capacità

Ogni gruppo di risorse è una collezione REST

Puoi ordinare un prelievo di sangue in clinica oppure un kit domiciliare per posta. Entrambi arrivano nello stesso formato, così scrivi il codice che legge i risultati una sola volta.

Profili · 4 endpoint

Un profilo è la persona che testi

Cerchi un profilo tramite email, lo crei nel tuo gruppo di profili e aggiorni i dati anagrafici in seguito.

Esami
GET /profiles
PATCH /profiles/{id}
Appuntamenti · 15 endpoint

Un appuntamento include i pannelli e il prelievo di sangue

Quindici endpoint coprono la prenotazione e ogni modifica successiva, inclusi i pannelli, le anteprime dei contenitori e la conferma.

Esami
POST /appointments
GET /appointments/{id}/results
Ordini di kit domiciliari · 10 endpoint

Gli ordini di kit domiciliari sono la versione postale

Dieci endpoint richiedono un kit fai-da-te per un profilo, ne modificano i pannelli e restituiscono la stessa struttura di risultato.

Esami
Crea un ordine di kit
Ricevi i risultati
Sedi · 2 endpoint

Le sedi ti indicano dove avviene un prelievo di sangue

Leggi le sedi che la tua chiave può prenotare, poi richiedi a una di esse gli orari di inizio degli slot prenotabili.

Esami
GET /locations
GET /locations/{id}/availability
Documenti · 1 endpoint

I risultati arrivano come righe cliniche e genetiche

Ogni tipo di ordine ha la propria chiamata per i risultati e il referto PDF è un download separato tramite ID file.

Esami
GET /appointments/{id}/results
GET /documents/{id}
Spedizioni · 8 endpoint

Un corriere porta il campione in laboratorio

Crei un ordine per il corriere con una fascia di ritiro feriale, poi colleghi gli appuntamenti e leggi gli aggiornamenti di stato.

Esami
POST /shipments
Allega appuntamenti
Cataloghi · 4 endpoint

I cataloghi elencano i biomarcatori che puoi ordinare

I cataloghi di biomarcatori, pannelli e unità sono paginati e puoi filtrare i biomarcatori per sede dell'esame.

Esami
GET /biomarkers
GET /panels
Salute · 1 endpoint

Un endpoint di readiness non richiede una chiave API

Il probe di readiness non richiede una chiave API, quindi il tuo monitor di uptime può chiamarlo secondo una pianificazione.

Esami
Verifica pubblica di disponibilità
Il tuo lavoro finisce alla conferma del codice a barre

Il processo di laboratorio inizia quando confermi il prelievo di sangue

Ci invii il codice a barre del kit, ed è l'ultima cosa che ci serve da te. Poi organizziamo noi i contenitori, il corriere e il laboratorio, così il tuo codice chiama solo due endpoint finché il referto non è pronto.

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 pallino pieno è il percorso che vuoi.Un anello è uno stato che gestisci ancora tu.Le linee arancioni sono l'ordine confermato.
Un solo parser legge un prelievo in clinica e un kit domiciliare

Ogni risultato ha due intervalli di riferimento e quattro stati

Ogni riga clinica include l'intervallo riportato dal laboratorio e l'intervallo Aniva con la sua finestra ottimale, così puoi mostrarli entrambi senza mantenere una tua tabella di riferimento.

Una riga indica pianificato prima che il laboratorio la analizzi.
Una riga mostra ricevuto non appena arrivano un valore e un'unità.
Una riga indica fault quando il laboratorio ha annullato la richiesta, e status_reason ne spiega il motivo.
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 usa tre formati temporali

I datetime richiedono un fuso orario, altrimenti la richiesta fallisce

Un datetime naive viene rifiutato con 400, che è l'errore più comune nelle prime integrazioni.

I timestamp vengono sempre restituiti in UTC, usando ISO 8601 con il suffisso Z.
Gli input devono includere un offset esplicito, quindi una prenotazione accetta 2026-05-15T12:30:00+02:00.
Gli aggiornamenti della spedizione mantengono l'offset orario indicato dal fornitore logistico.
I campi calendario si basano solo sul tempo locale, come una data di nascita.
Aniva emette e ruota ogni chiave partner

Per ogni richiesta serve la tua chiave API partner

L'autenticazione usa l'header x-api-key a ogni chiamata, e una chiave mancante o ruotata restituisce 403 con un breve errore JSON.

La tua chiave decide quali sedi, appuntamenti e spedizioni puoi vedere.
Non esporre mai la tua chiave API nel codice lato client o in repository pubblici.
Una verifica pubblica non richiede una chiave API

Puoi monitorare ogni servizio sulla pagina di stato

La pagina di stato mostra la situazione attuale e 90 giorni di storico per ogni servizio, e gli stessi dati sono disponibili in JSON per il tuo monitoraggio.

Le chiavi partner vengono rilasciate dal nostro team

Chiedici oggi una chiave partner

Dicci in quali mercati vendi e quali pannelli ti servono, e ti invieremo una chiave con i permessi giusti.

Puoi anche scaricare il file OpenAPI

Questa pagina è un mockup di design. Ogni endpoint e payload presente è tratto da docs.anivahealth.com e il diagramma della pipeline è illustrativo.

Copie della documentazione leggibili automaticamente sono disponibili su docs.anivahealth.com/llms.txt e docs.anivahealth.com/llms-full.txt.