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

# Creează un profil

> Ghid pas cu pas: creează și actualizează profiluri de pacienți în Aniva Partner API înainte să programezi o analiză de sânge.

Folosește acest ghid pentru a crea un profil de pacient și a-l asocia grupului tău de profiluri. Profilurile sunt punctul de plecare pentru a face programări și a iniția comenzi de laborator.

**1. Obține referința grupului tău de profiluri**

Fiecare profil trebuie asociat unui grup de profiluri care aparține contului tău de partener. Câmpul `profile_group` acceptă fie UUID-ul imuabil al grupului, fie slug-ul său ușor de citit — UUID-ul este recomandat deoarece nu se schimbă niciodată și rămâne valabil chiar dacă slug-ul este redenumit.

Dacă nu știi referința grupului tău de profiluri, contactează Aniva pentru a o obține. Nu poți crea profiluri fără o referință validă.

**2. Creează profilul**

Trimite o cerere `POST` către `/api/v1/profiles` cu datele demografice ale pacientului.

> [!NOTE]
>
> Atât `first_name`, cât și `last_name` sunt obligatorii. Acceptă doar litere din alfabetul latin (inclusiv litere cu diacritice, precum ü), spații, cratime și apostrofuri. Transliterează numele scrise în alte alfabete înainte să le trimiți.

> [!NOTE]
>
> Dacă omiți `email`, Aniva generează automat o adresă de e-mail provizorie pentru profil. O poți actualiza ulterior printr-o cerere `PATCH`.

> [!TIP]
>
> Câmpul `language` controlează limba pe care o folosește Aniva în comunicarea cu pacientul — de exemplu, mementourile pentru programări și notificările despre rezultate. Setează-l în funcție de limba preferată a pacientului. [Creare profil](https://docs.anivahealth.com/ro/api/profiles/create-profile.md) enumeră valorile acceptate. Valoarea implicită este `en`.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "first_name": "Emma",
    "last_name": "Müller",
    "sex": 2,
    "date_of_birth": "1990-04-15",
    "profile_group": "my-clinic-group",
    "email": "emma.muller@example.com",
    "language": "de"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/profiles', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    first_name: 'Emma',
    last_name: 'Müller',
    sex: 2,
    date_of_birth: '1990-04-15',
    profile_group: 'my-clinic-group',
    email: 'emma.muller@example.com',
    language: 'de',
  }),
});

const profile = await response.json();
```

O cerere reușită returnează `201 Created` împreună cu noul obiect de profil:

```json theme={null}
{
  "id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
  "handle": null,
  "first_name": "Emma",
  "last_name": "Müller",
  "email": "emma.muller@example.com",
  "phone": null,
  "sex": 2,
  "date_of_birth": "1990-04-15",
  "height": null,
  "weight": null,
  "language": "de",
  "transactional_emails_enabled": null,
  "created_at": "2026-04-01T09:14:22Z",
  "updated_at": null
}
```

Salvează `id` — vei avea nevoie de el pentru a face programări și a actualiza profilul.

**3. Actualizează profilul (opțional)**

Folosește `PATCH /api/v1/profiles/{id}` pentru a actualiza orice câmp al profilului după creare. Toate câmpurile sunt opționale — include doar câmpurile pe care vrei să le modifici.

Exemplul următor adaugă un număr de telefon și înălțimea:

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56 \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "phone": "+4915123456789",
    "height": 168.5
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
  {
    method: 'PATCH',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      phone: '+4915123456789',
      height: 168.5,
    }),
  }
);

const updated = await response.json();
```

O cerere reușită returnează `200 OK` împreună cu obiectul complet al profilului actualizat.

## Gestionarea erorilor

| Status | Cauză | Soluție |
| - | - | - |
| `400 Bad Request` | Lipsește un câmp obligatoriu, o valoare este în afara intervalului sau `date_of_birth` nu este plauzibilă (în viitor, înainte de 1900 ori implică o vârstă în afara intervalului 16–100). | Verifică corpul răspunsului de eroare pentru mesajul specific de validare și corectează cererea. |
| `403 Forbidden` | Cheia ta API nu are acces la această operațiune sau nu ai acces la grupul de profiluri specificat. | Contactează Aniva pentru a confirma permisiunile cheii tale API și accesul la grupul de profiluri. |
| `404 Not Found` | Valoarea `profile_group` nu corespunde niciunui grup de profiluri din contul tău (nici după UUID, nici după slug). | Verifică dacă referința este corectă. Contactează Aniva dacă nu ești sigur de UUID sau slug. |
| `409 Conflict` | Există deja un profil pentru acest `email` (`error_name: "email_exists_error"`), sau un `Idempotency-Key` a fost refolosit cu un alt corp de cerere. | Folosește profilul existent pentru acel e-mail sau trimite un nou `Idempotency-Key`. |


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