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

> Hozz létre egy új páciensprofilt, és rendeld hozzá egy profilcsoporthoz

Hozz létre egy új páciensprofilt, és rendeld hozzá egy profilcsoporthoz. A profil tárolja az időpontokhoz és laborrendelésekhez használt demográfiai adatokat.

A `create_user` scope szükséges hozzá.

Küldj opcionális `Idempotency-Key` fejlécet, hogy a létrehozás biztonságosan újrapróbálható legyen — ugyanazzal a kulccsal megismételve az eredeti válasz érkezik vissza egy újabb létrehozása helyett. Lásd: [Idempotencia](https://docs.anivahealth.com/hu/concepts/idempotency.md).

## Kérés

### Törzsparaméterek

**first\_name** `string` *required*

A páciens keresztneve. Latin karaktereket kell tartalmaznia, 1 és 100 karakter között.

**last\_name** `string` *required*

A páciens vezetékneve. Latin karaktereket kell tartalmaznia, 1 és 100 karakter között. A
laboratóriumok elutasítják a vezetéknév nélküli páciensek rendeléseit, ezért enélkül nem hozható
létre profil.

Három érték fenntartott a tesztadatok előkészítésére – lásd: [Sandbox tesztadatok](#sandbox-tesztadatok).

**sex** `integer` *required*

Biológiai nem az ISO/IEC 5218 szabvány szerint. Férfi esetén `1`, nő esetén `2`. A
laboratóriumnak a referenciatartományokhoz szüksége van rá, ezért a `0` (ismeretlen) `400`-at ad
vissza. Kötelező, hacsak a profilcsoportod nem engedi, hogy a páciens a tesztkészlet aktiválási
oldalán adja meg. Ebben az esetben hagyd el. Lásd:
[Születési dátum és nem megadása a páciens által](https://docs.anivahealth.com/hu/concepts/profiles.md#hagyd-hogy-a-paciens-adja-meg-a-szueletesi-datumat-es-a-nemet).

**date\_of\_birth** `string` *required*

Születési dátum `YYYY-MM-DD` formátumban. Múltbeli dátumnak kell lennie, 1900-nál nem korábbinak.
Az ebből számított életkornak 16 és 100 év között kell lennie. Más értékek `400`-at adnak vissza.
Kötelező, hacsak a profilcsoportod nem engedi, hogy a páciens a tesztkészlet aktiválási oldalán
adja meg. Ebben az esetben hagyd el.

**profile\_group** `string` *required*

Polimorf hivatkozás (UUID vagy slug) arra a profilcsoportra, amelyhez ezt a profilt hozzá
szeretnéd rendelni. Az UUID megváltoztathatatlan azonosító, és a slug átnevezése után is érvényes
marad; a slug továbbra is elfogadott az olvasható azonosítókra épülő marketing- és
partnerintegrációkhoz. Az UUID használata ajánlott. A profilcsoportnak az API-kulcsod hozzáférési
körén belül kell lennie. Kötelező, hacsak nem az elavult `profile_group_slug` mezőt küldöd el.

**profile\_group\_slug** `string` *deprecated*

Elavult: használd a `profile_group` mezőt. A profilcsoport slugja. Csak kisbetűk, számjegyek,
kötőjelek és aláhúzások szerepelhetnek benne.

**email** `string`

A profil e-mail-címe. Ha elhagyod, az Aniva automatikusan generál egy e-mail-címet.

Az `email` megadása **biztonságosan megismételhetővé** is teszi a létrehozást: egy címhez csak egy
profil tartozhat, így egy megismételt kérés újabb profil helyett `409`-et ad vissza. Az
automatikusan generált címek kérésenként egyediek. Küldj `email` mezőt vagy `Idempotency-Key`
fejlécet, ha az integrációd újrapróbálkozik.

**phone** `string`

Telefonszám E.164 formátumban (pl. `+14155552671`).

**height** `number`

Magasság centiméterben.

**weight** `number`

Testsúly kilogrammban.

**language** `string` (default: en)

A profil preferált nyelve: `en`, `bg`, `ca`, `cs`, `da`, `de`, `el`, `es`, `et`, `fi`, `fr`, `ga`, `hr`, `hu`, `is`, `it`, `lb`, `lt`, `lv`, `mt`, `nl`, `no`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `tr` vagy `uk`. Alapértelmezés szerint `en`.

**transactional\_emails\_enabled** `boolean`

Kapjon-e ez a profil tranzakciós (automatikus) e-maileket – időpont-visszaigazolásokat, az
eredmények elkészültéről szóló értesítéseket stb. Felülírja a profilcsoport alapértelmezését.
Független a marketing-hozzájárulástól. Hagyd el az alapértelmezett érték használatához.

**marketing\_emails\_enabled** `boolean`

Hozzájárul-e ez a profil a marketing e-mailekhez (hírlevelek, termékújdonságok). Felülírja a
profilcsoport alapértelmezését. Független a tranzakciós e-mailektől. Hagyd el a profilcsoport
alapértelmezett értékének használatához. Csak írható: a profil válaszában nem szerepel.

## Sandbox tesztadatok

Minden tesztelésre érdemes lekérdezési útvonal – [Időpontok listázása](https://docs.anivahealth.com/hu/api/appointments/list-appointments.md),
[Eredmények lekérése](https://docs.anivahealth.com/hu/api/appointments/get-results.md),
[Dokumentum letöltése](https://docs.anivahealth.com/hu/api/documents/download-document.md) – üres marad, amíg napokkal később meg nem
történik egy valódi vérvétel. Ez megnehezíti az automatizált integrációs tesztek megírását.

Ennek megoldására három `last_name` érték van fenntartva. Hozz létre egy profilt valamelyikkel, és
az Aniva már a válasz előtt előre feltölti az alábbi állapotot, így a következő hívásod már látni
fogja:

| `last_name` | Mit kap a profil |
| - | - |
| `Upcomingtestmann` | Egy közelgő `confirmed` időpont hozzárendelt panellel. Még nincsenek eredmények. |
| `Partialtestmann` | Egy múltbeli `blood_drawn` időpont. A panel nagyjából **fele** elkészült; az [Eredmények lekérése](https://docs.anivahealth.com/hu/api/appointments/get-results.md) állapota `in_progress`. |
| `Fulltestmann` | Egy múltbeli `blood_drawn` időpont. A panel **összes** biomarkere elkészült, `status: "completed"`, és egy PDF laborlelet szerepel a `documents[]` mezőben. |

Az egyezés nem érzékeny a kis- és nagybetűkre. Minden más mezőt – beleértve a `date_of_birth` és a
`sex` mezőt is – a szokásos módon tárol és használ a rendszer, így a visszakapott
referenciatartományok a létrehozott profil valódi, életkor- és nemspecifikus tartományai.

Az időpontot az **Aniva Test** helyszínre foglaljuk egy valós, foglalható idősávba, legalább öt nappal
későbbre (vagy öt nappal korábbra a múltbeli állapotoknál). A feltöltés nem ad le laborrendelést, és nem foglal
futárt.

> [!NOTE]
>
> A tesztprofiloknak olyan címet adj meg, amelyet te kezelsz. Az Aniva időpont-emlékeztetőit a
> `scheduled_at` vezérli, így a közelgő tesztadat kiküldi őket, hacsak a profilnál nincs letiltva a
> `transactional_emails_enabled: false` beállítással.

A rendszer véletlenszerűen választ ki egy panelt az API-kulcsod számára látható panelek közül, így a `panel_id` mindig feloldható
a saját [Panelek listázása](https://docs.anivahealth.com/hu/api/panels/list-panels.md) alapján. A klinikai biomarkerek a
biomarker referenciatartományán belüli értéket kapnak; a gének véletlenszerű genotípust az Aniva referenciaadataiból, az ebből adódó megfelelő variánsokkal, klinikai jelentőséggel és rs-azonosítókkal.

> [!NOTE]
>
> A panel és az értékek minden létrehozáskor újragenerálódnak, ezért a struktúrát ellenőrizd, ne egy adott
> panelt vagy pontos számokat.

## Válasz

Siker esetén az API `201 Created` választ ad vissza az újonnan létrehozott profillal.

**id** `string` *required*

Egyedi profilazonosító (UUID).

**handle** `string`

Profil handle vagy felhasználónév. Lehet `null`.

**first\_name** `string`

Keresztnév. Lehet `null`.

**last\_name** `string`

Vezetéknév. Lehet `null`.

**email** `string`

E-mail-cím. Lehet `null`.

**phone** `string`

Telefonszám E.164 formátumban. Lehet `null`.

**sex** `integer`

Biológiai nem az ISO/IEC 5218 szerint (`0` = ismeretlen, `1` = férfi, `2` = nő). Lehet `null`.

**date\_of\_birth** `string`

Születési dátum `YYYY-MM-DD` formátumban. Lehet `null`.

**height** `number`

Magasság centiméterben. Lehet `null`.

**weight** `number`

Testsúly kilogrammban. Lehet `null`.

**language** `string`

Preferált nyelv, a fenti 32 kód egyike.

**transactional\_emails\_enabled** `boolean`

Kap-e ez a profil tranzakciós (automatikus) e-maileket. `null`, ha még soha nem állították be.

**created\_at** `string`

A profil létrehozásának ISO 8601 időbélyege.

**updated\_at** `string`

Az utolsó frissítés ISO 8601 időbélyege. Újonnan létrehozott profiloknál `null`.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `400` | Validációs hiba — egy vagy több mező érvényesítése sikertelen. |
| `403` | Tiltott — az API-kulcsodnak nincs jogosultsága ehhez a művelethez, vagy a profilcsoport a hozzáférési körödön kívül esik. |
| `404` | A profilcsoport nem található. |
| `409` | Már létezik profil a megadott `email` címhez (a válasz tartalmazza a címet) vagy ugyanahhoz a személyhez (lásd alább), vagy az `Idempotency-Key` értéket más törzzsel használtad újra, esetleg az eredeti kérése még nem fejeződött be. |
| `500` | Belső szerverhiba. |

Egy `409` válasz így néz ki — kezeld úgy, hogy „ez a profil már létezik”, és keresd meg a
[Profilok listázása](https://docs.anivahealth.com/hu/api/profiles/list-profiles.md) (`?email=`) segítségével a létrehozás újrapróbálása helyett:

```json theme={null}
{
  "error": "An account with the email \"maria.schmidt@example.com\" already exists.",
  "error_name": "email_exists_error",
  "email": "maria.schmidt@example.com"
}
```

Ha egy személynek ugyanaz a keresztneve, vezetékneve, neme és születési dátuma, mint egy olyan profilnak, amelyet a kulcsod lát,
`409` választ kapsz `error_name: "duplicate_profile_error"` értékkel. Használd a visszaadott `profile_id` azonosítót
egy második profil létrehozása helyett:

```json theme={null}
{
  "error": "A patient named \"Maria Schmidt\", born 02-04-1990, with the same biological sex already exists as m***@example.com. Search for that patient and select them instead of creating a duplicate.",
  "error_name": "duplicate_profile_error",
  "profile_id": "3f1c2a8e-5b7d-4c9e-8a21-6d4f0b9e7c35",
  "full_name": "Maria Schmidt",
  "date_of_birth": "1990-04-02",
  "masked_email": "m***@example.com"
}
```

A tesztadatokat feltöltő sandbox vezetéknevek kivételt képeznek.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "first_name": "Maria",
    "last_name": "Schmidt",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "profile_group": "acme-clinic-berlin",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "marketing_emails_enabled": false
  }'
```

```json 201 theme={null}
{
  "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "handle": null,
  "first_name": "Maria",
  "last_name": "Schmidt",
  "email": "maria.schmidt@example.com",
  "phone": "+4930123456789",
  "sex": 2,
  "date_of_birth": "1985-03-22",
  "height": 168,
  "weight": 65,
  "language": "de",
  "transactional_emails_enabled": true,
  "created_at": "2026-04-01T09:14:32Z",
  "updated_at": null
}
```

```json 400 theme={null}
{
  "error": "date_of_birth: Birthdate cannot be in the future."
}
```

```json 404 theme={null}
{
  "error": "Profile group 'acme-clinic-berlin' not found"
}
```


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