> ## 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.

# Introducere

> Prezentare generală a Aniva Partner API, un API REST pentru analize de sânge în farmacii și cabinete, kituri de testare la domiciliu și rezultate de laborator.

Aniva Partner API este un API REST care le permite partenerilor din domeniul medical să gestioneze profilurile pacienților, să facă programări de recoltare de sânge în locațiile de testare și să inițieze fluxurile de comenzi de laborator. Interacționezi cu API-ul prin HTTPS folosind cheia ta API de partener.

## Ce poți face

* **Gestionarea profilurilor** — Creează, preia și actualizează profilurile demografice ale pacienților.
* **Stabilirea programărilor** — Fă programări pentru recoltare de sânge în locațiile de testare Aniva.
* **Gestionarea panelurilor** — Adaugă sau elimină paneluri de analize de laborator la o programare existentă.
* **Biomarkeri individuali** — Atașează sau elimină biomarkeri individuali la o programare, fără a alege un panel.
* **Comenzi de kituri de testare la domiciliu** — Trimite un kit de testare la domiciliu unui pacient, urmărește coletele și raportează când a fost colectată proba.
* **Catalog de paneluri** — Răsfoiește panelurile disponibile cu `GET /api/v1/panels` pentru a afla ID-urile panelurilor și biomarkerii incluși în fiecare.
* **Catalog de biomarkeri** — Răsfoiește biomarkerii pe care îi poți comanda într-o locație sau într-un kit de testare la domiciliu cu `GET /api/v1/biomarkers` pentru a le afla ID-urile.
* **Confirmarea recoltării de sânge** — Trimite codul sau codurile de laborator după o recoltare de sânge pentru a iniția fluxul de comenzi de laborator.
* **Rezultate de laborator** — Preia rezultatele clinice și genetice și descarcă rapoartele de laborator în format PDF.
* **Găsirea locațiilor** — Listează locațiile de testare disponibile pentru a le afișa pacienților.
* **Logistica expedierilor** — Creează, urmărește, modifică și anulează comenzi de expediere prin curier.
* **Webhooks** — Primește un apel HTTPS când se modifică o programare, o comandă de kit de testare la domiciliu, rezultatele acesteia, o locație, un profil sau o expediere. Vezi [Webhooks](https://docs.anivahealth.com/ro/concepts/webhooks.md).

## Explorează documentația

> [card] [Autentificare](https://docs.anivahealth.com/ro/authentication.md)
>
> Autentifică cererile cu cheia ta API de partener.

> [card] [Start rapid](https://docs.anivahealth.com/ro/quickstart.md)
>
> Fă primul tău apel API în câteva minute cu exemple pas cu pas.

> [card] [Profiluri](https://docs.anivahealth.com/ro/concepts/profiles.md)
>
> Află cum funcționează profilurile pacienților și ce date conțin.

> [card] [Programări](https://docs.anivahealth.com/ro/concepts/appointments.md)
>
> Înțelege ciclul de viață al programării, de la stabilire la confirmare.

> [card] [Comenzi de kituri de testare la domiciliu](https://docs.anivahealth.com/ro/concepts/home-kit-orders.md)
>
> Trimite un kit de testare la domiciliul unui pacient și urmărește-l până când proba ajunge la laborator.

## Versionarea API-ului

Versiunea curentă a API-ului este **v1**. Toate endpoint-urile au prefixul `/api/v1/`. URL-ul de bază este `https://anivahealth.com`.

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

Modificările care afectează compatibilitatea vor fi introduse sub un nou prefix de versiune. API-ul v1 va rămâne disponibil, cu notificare prealabilă pentru orice retragere din uz.

## Date și fusuri orare

Toate momentele transmise prin rețea sunt în format **UTC ISO 8601** (sufix `Z`). Câmpurile strict calendaristice folosesc **componente de dată/oră
locală** (`YYYY-MM-DD`, `HH:MM`).

| Categorie | Format | Utilizat pentru |
| - | - | - |
| **Moment** | ISO 8601 în UTC (sufix `Z`, de ex. `2026-04-15T08:30:00Z`) | Fiecare dată și oră din răspunsuri — `scheduled_at` al programării, `slots[]` din disponibilitate, `pickup.from` / `pickup.till` al expedierii, `created_at`, `updated_at`, `added_at`. Afișează-le în orice fus orar local din client. |
| **Eveniment de la furnizor** | ISO 8601 cu decalajul furnizorului din amonte (transmis nemodificat) | Doar `status_updates[].time` al expedierii — decalajul reflectă ce a raportat curierul. |
| **Dată/oră locală** | `YYYY-MM-DD` pentru date, `HH:MM` pentru ore — fără decalaj | Valori strict calendaristice sau ore din zi — `date_of_birth`, `tested_at` al rezultatelor, `start_date` / `end_date` din disponibilitate, `pickup_date` / `pickup_time_from` / `pickup_time_till` al expedierii, `open_hours` al locației. |

Note specifice:

* **Câmpurile de intrare care acceptă o dată cu oră** (de ex. `scheduled_at` la `POST` / `PATCH /api/v1/appointments`)
  **trebuie să includă un indicator de fus orar** — fie `Z`, fie un decalaj explicit precum `+02:00`. Valorile
  fără fus orar sunt respinse cu `400`. Ambele forme codifică același moment; răspunsul
  returnează întotdeauna `scheduled_at` în format UTC `Z`. Folosește câmpul `timezone` al locației (sau orice alt identificator
  IANA) pentru a formata momentul în ora locală la afișare.
* **Intrările de dată/oră locală** sunt interpretate în fusul orar al resursei vizate: datele de
  disponibilitate folosesc parametrul de interogare `timezone` (implicit fusul orar al locației); câmpurile
  `pickup_date` / `pickup_time_*` ale expedierii sunt interpretate în fusul orar al locației de origine.
* **Câmpurile de răspuns doar cu dată** (de ex. `tested_at`, `availability[].date` din disponibilitate) sunt
  date calendaristice fără fus orar.

## Obținerea accesului

Cheile API sunt emise de Aniva pentru fiecare partener.

> [!NOTE]
>
> Contactează Aniva pentru a primi cheia ta API de partener.


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