> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduzione

> Panoramica dell'Aniva Partner API, un'API REST per esami del sangue in farmacie e studi medici, kit domiciliari e risultati di laboratorio.

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](https://docs.anivahealth.com/it/concepts/webhooks.md).

## Esplora la documentazione

> [card] [Autenticazione](https://docs.anivahealth.com/it/authentication.md)
>
> Autentica le richieste con la tua chiave API partner.

> [card] [Avvio rapido](https://docs.anivahealth.com/it/quickstart.md)
>
> Fai la tua prima chiamata API in pochi minuti con esempi passo passo.

> [card] [Profili](https://docs.anivahealth.com/it/concepts/profiles.md)
>
> Scopri come funzionano i profili dei pazienti e quali dati contengono.

> [card] [Appuntamenti](https://docs.anivahealth.com/it/concepts/appointments.md)
>
> Comprendi il ciclo di vita di un appuntamento, dalla prenotazione alla conferma.

> [card] [Ordini di kit domiciliari](https://docs.anivahealth.com/it/concepts/home-kit-orders.md)
>
> 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`.

```text theme={null}
https://anivahealth.com/api/v1/
```

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`).

| Categoria | Formato | Usato per |
| - | - | - |
| **Istante** | ISO 8601 in UTC (suffisso `Z`, es. `2026-04-15T08:30:00Z`) | Ogni data e ora in output — `scheduled_at` dell'appuntamento, `slots[]` della disponibilità, `pickup.from` / `pickup.till` della spedizione, `created_at`, `updated_at`, `added_at`. Visualizza in qualsiasi fuso orario locale lato client. |
| **Evento del provider** | ISO 8601 con l'offset del provider a monte (trasmesso invariato) | Solo `status_updates[].time` della spedizione — l'offset riflette quanto riportato dal corriere. |
| **Ora locale** | `YYYY-MM-DD` per le date, `HH:MM` per gli orari — senza offset | Valori di solo calendario o ora del giorno — `date_of_birth`, `tested_at` dei risultati, `start_date` / `end_date` della disponibilità, `pickup_date` / `pickup_time_from` / `pickup_time_till` della spedizione, `open_hours` della sede. |

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.

> [!NOTE]
>
> Contatta Aniva per ricevere la tua chiave API partner.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.