Vai al contenuto principale
L’Aniva Partner API è una REST API che consente ai partner sanitari di gestire i profili dei pazienti, prenotare appuntamenti per il prelievo di sangue presso le sedi di analisi e avviare le pipeline degli ordini di laboratorio. Interagisci con l’API tramite HTTPS usando la tua chiave API partner.

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/panels per 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/biomarkers per 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.
Le modifiche non retrocompatibili verranno introdotte con un nuovo prefisso di versione. L’API v1 resterà disponibile con preavviso per eventuali deprecazioni.

Date e fusi orari

Tutti gli istanti trasmessi sono in UTC ISO 8601 (suffisso Z). 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_at in POST / PATCH /api/v1/appointments) devono includere un indicatore di fuso orario — Z oppure un offset esplicito come +02:00. Le date e ore senza fuso orario vengono rifiutate con 400. Entrambe le forme codificano lo stesso istante; la risposta restituisce sempre scheduled_at in UTC Z. Usa il campo timezone della 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 campi pickup_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[].date della 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.