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
45 endpoint sono documentati e attivi oggi
L'autenticazione richiede un solo header di richiesta
Ogni percorso inizia con il prefisso v1
Le sedi in Germania possono fare il prelievo di sangue
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Chiedici oggi una chiave partner
Dicci in quali mercati vendi e quali pannelli ti servono, e ti invieremo una chiave con i permessi giusti.
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.