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

# Profil létrehozása

> Lépésről lépésre útmutató: hozz létre és frissíts páciensprofilokat az Aniva Partner API-ban, mielőtt vérvizsgálatot foglalsz.

Ezzel az útmutatóval páciensprofilt hozhatsz létre, és hozzárendelheted a profilcsoportodhoz. A profilok jelentik a kiindulópontot az időpontok foglalásához és a laborrendelések elindításához.

**1. Profilcsoport-hivatkozás beszerzése**

Minden profilt hozzá kell rendelni egy, a partnerfiókodhoz tartozó profilcsoporthoz. A `profile_group` mező elfogadja a csoport nem módosítható UUID-ját vagy az ember által olvasható slugját is — az UUID ajánlott, mert soha nem változik, és a slug átnevezése után is érvényes marad.

Ha nem ismered a profilcsoport-hivatkozásodat, vedd fel a kapcsolatot az Anivával a lekéréséhez. Érvényes hivatkozás nélkül nem tudsz profilokat létrehozni.

**2. Profil létrehozása**

Küldj egy `POST` kérést a `/api/v1/profiles` végpontra a páciens demográfiai adataival.

> [!NOTE]
>
> A `first_name` és a `last_name` mező is kötelező. Csak latin betűket (beleértve az ékezetes betűket is, például ü), szóközöket, kötőjeleket és aposztrófokat fogadnak el. A más írásrendszerű neveket beküldés előtt írd át latin betűsre.

> [!NOTE]
>
> Ha elhagyod az `email` mezőt, az Aniva automatikusan generál egy helykitöltő e-mail-címet a profilhoz. Ezt később egy `PATCH` kéréssel frissítheted.

> [!TIP]
>
> A `language` mező határozza meg, milyen nyelven kommunikál az Aniva a pácienssel – például időpont-emlékeztetőkben és eredményértesítésekben. Állítsd be a páciens preferált nyelvére. A támogatott értékeket a [Profil létrehozása](https://docs.anivahealth.com/hu/api/profiles/create-profile.md) oldal sorolja fel. Alapértelmezés szerint `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();
```

Sikeres kérés esetén a válasz `201 Created` az új profilobjektummal:

```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
}
```

Mentsd el az `id` értéket — szükséged lesz rá az időpontok foglalásához és a profil frissítéséhez.

**3. Profil frissítése (opcionális)**

A `PATCH /api/v1/profiles/{id}` végponttal a létrehozás után bármely profilmezőt frissítheted. Minden mező opcionális — csak azokat add meg, amelyeket módosítani szeretnél.

Az alábbi példa telefonszámot és magasságot ad hozzá:

```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();
```

Sikeres kérés esetén a válasz `200 OK` a teljes, frissített profilobjektummal.

## Hibakezelés

| Státusz | Ok | Megoldás |
| - | - | - |
| `400 Bad Request` | Egy kötelező mező hiányzik, egy érték a tartományon kívül esik, vagy a `date_of_birth` életszerűtlen (jövőbeli, 1900 előtti, vagy 16–100 éven kívüli életkort eredményez). | Ellenőrizd a hibaválasz törzsében a pontos validációs üzenetet, és javítsd a kérést. |
| `403 Forbidden` | Az API-kulcsodnak nincs jogosultsága ehhez a művelethez, vagy nincs hozzáférésed a megadott profilcsoporthoz. | Vedd fel a kapcsolatot az Anivával az API-kulcsod jogosultságainak és a profilcsoport-hozzáférésednek ellenőrzéséhez. |
| `404 Not Found` | A `profile_group` értéke nem egyezik a fiókod egyetlen profilcsoportjával sem (sem UUID, sem slug alapján). | Ellenőrizd, hogy a hivatkozás helyes-e. Ha nem vagy biztos az UUID-dban vagy a slugodban, vedd fel a kapcsolatot az Anivával. |
| `409 Conflict` | Már létezik profil ehhez az `email` címhez (`error_name: "email_exists_error"`), vagy egy `Idempotency-Key` fejlécet újrahasználtál más kéréstörzzsel. | Használd az adott e-mail-címhez tartozó meglévő profilt, vagy küldj új `Idempotency-Key` értéket. |


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