Cosa puoi fare
- Gestione dei profili — Crea, recupera e aggiorna i profili anagrafici dei pazienti.
- Prenotazione degli appuntamenti — Prenota appuntamenti per il prelievo di sangue presso le sedi di analisi Aniva.
- Gestione dei pannelli — Aggiungi o rimuovi pannelli di esami di laboratorio in un appuntamento esistente.
- Singoli biomarcatori — Aggiungi o rimuovi singoli biomarcatori in un appuntamento senza scegliere un pannello.
- Ordini di kit domiciliari — Invia un kit di analisi a domicilio a un paziente, traccia i pacchi e segnala quando il campione è stato raccolto.
- Catalogo dei pannelli — Consulta i pannelli disponibili con
GET /api/v1/panelsper scoprire gli ID dei pannelli e i biomarcatori inclusi. - Catalogo dei biomarcatori — Consulta i biomarcatori che puoi ordinare presso una sede o in un kit domiciliare con
GET /api/v1/biomarkersper scoprirne gli ID. - Conferma del prelievo di sangue — Invia il codice o i codici di laboratorio dopo un prelievo di sangue per avviare la pipeline degli ordini di laboratorio.
- Risultati di laboratorio — Recupera risultati clinici e genetici e scarica i PDF dei referti di laboratorio.
- Ricerca delle sedi — Elenca le sedi di analisi disponibili da mostrare ai pazienti.
- Logistica delle spedizioni — Crea, traccia, modifica e annulla gli ordini di spedizione tramite corriere.
- Webhook — Ricevi una chiamata HTTPS quando ci sono modifiche a un appuntamento, un ordine di kit domiciliare, i suoi risultati, una sede, un profilo o una spedizione. Vedi Webhook.
Esplora la documentazione
Autenticazione
Autentica le richieste con la tua chiave API partner.
Avvio rapido
Fai la tua prima chiamata API in pochi minuti con esempi passo passo.
Profili
Scopri come funzionano i profili dei pazienti e quali dati contengono.
Appuntamenti
Comprendi il ciclo di vita di un appuntamento, dalla prenotazione alla conferma.
Ordini di kit domiciliari
Invia un kit di analisi a casa di un paziente e seguilo fino all’arrivo del campione in laboratorio.
Versioni dell’API
La versione attuale dell’API è la v1. Tutti gli endpoint hanno il prefisso/api/v1/. L’URL di base è https://anivahealth.com.
Date e fusi orari
Tutti gli istanti trasmessi sono in UTC ISO 8601 (suffissoZ). I campi di solo calendario usano valori di data e
ora locale (YYYY-MM-DD, HH:MM).
Note specifiche:
- Gli input che accettano data e ora (es.
scheduled_atinPOST/PATCH /api/v1/appointments) devono includere un indicatore di fuso orario —Zoppure un offset esplicito come+02:00. Le date e ore senza fuso orario vengono rifiutate con400. Entrambe le forme codificano lo stesso istante; la risposta restituisce semprescheduled_atin UTCZ. Usa il campotimezonedella sede (o qualsiasi altro identificatore IANA) per formattare l’istante nell’ora locale al momento della visualizzazione. - Gli input in ora locale vengono interpretati nel fuso orario della risorsa di destinazione: le date di
disponibilità usano il parametro query
timezone(il valore predefinito è il fuso orario della sede); i campipickup_date/pickup_time_*della spedizione vengono interpretati nel fuso orario della sede di origine. - I campi di risposta con sola data (es.
tested_at,availability[].datedella disponibilità) sono date di calendario senza fuso orario.
Ottenere l’accesso
Le chiavi API vengono rilasciate da Aniva per ciascun partner.Contatta Aniva per ricevere la tua chiave API partner.