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

# Profilok

> Így működnek a páciensprofilok az Aniva Partner API-ban: hozd létre, frissítsd és kapcsold össze azoknak a profilját, akiknek vérvizsgálatot és otthoni tesztkészletet foglalsz.

A profil egy pácienst vagy felhasználót leíró rekord az Aniva rendszerében. Minden időpont, laboratóriumi rendelés és eredmény egy profilhoz tartozik.

## Profilcsoportok

Amikor profilt hozol létre, a `profile_group` paraméterrel hozzárendeled egy **profilcsoporthoz**. A profilcsoport a partnerfiókod alatt rendszerezi a profilokat, és egy adott programhoz vagy integrációhoz köti őket.

A `profile_group` mező elfogadja a csoport megváltoztathatatlan UUID-jét vagy az ember által olvasható slugját is. Az UUID a tartós hivatkozás – soha nem változik, és a slug átnevezése után is érvényes marad. A slug az olvasható URL-ekhez és partnerintegrációkhoz való.

Létrehozáskor kötelező megadni a `profile_group` értékét (UUID vagy slug). A régi `profile_group_slug` mező elavult aliasként továbbra is elfogadott.

## Mezők

**id** `string` *required*

Az Aniva által automatikusan generált UUID. Ezzel hivatkozhatsz a profilra más API-hívásokban.

**handle** `string`

A profil opcionális felhasználóneve vagy rövid azonosítója. Lehet null.

**first\_name** `string`

A páciens keresztneve. Csak latin karakterek, 1–100 karakter. Létrehozáskor kötelező.

**last\_name** `string`

A páciens vezetékneve. Csak latin karakterek, 1–100 karakter. Létrehozáskor kötelező – a
laboratóriumok elutasítják a vezetéknév nélküli páciensek rendeléseit. A kötelezővé tétele előtt
létrehozott profiloknál lehet null.

**email** `string`

A páciens e-mail-címe. Ha létrehozáskor nem adsz meg egyet, az Aniva automatikusan generál egy
helykitöltő e-mail-címet.

**phone** `string`

Telefonszám [E.164 formátumban](https://www.itu.int/rec/T-REC-E.164/en) (pl. `+14155552671`).
Lehet null.

**sex** `integer`

Biológiai nem az [ISO/IEC 5218](https://www.iso.org/standard/36266.html) szerint: `1` = férfi,
`2` = nő. Létrehozáskor kötelező, hacsak a profilcsoportod nem engedi, hogy a páciens adja meg
(lásd alább). A laboratóriumnak szüksége van rá a referenciatartományokhoz, ezért a `0`
(ismeretlen) értékkel történő létrehozás vagy frissítés `400`-at ad vissza. A 2026. szeptember 30.
előtt létrehozott profilok továbbra is `0`-t adhatnak vissza.

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

Születési dátum `YYYY-MM-DD` formátumban. Létrehozáskor kötelező, hacsak a profilcsoportod nem
engedi meg a páciensnek, hogy maga adja meg (lásd alább). A múltban kell lennie, 1900-nál nem
korábbinak, és 16 és 100 év közötti életkort kell jelentenie; a valószerűtlen értékeket a
rendszer `400` hibakóddal elutasítja. A születési dátumot a rendeléssel együtt elküldjük a
laboratóriumnak, és a rendelés leadása után már nem módosítható.

**height** `number`

Magasság centiméterben. Lehet null.

**weight** `number`

Testsúly kilogrammban. Lehet null.

**language** `string`

A páciensnek szóló kommunikáció előnyben részesített nyelve. Elfogadott értékek: `en`, `de`, `fi`.

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

Megadja, hogy a profil kap-e tranzakciós e-maileket, például időpont-visszaigazolásokat és az
eredmények elkészültéről szóló értesítéseket. Független a marketing-hozzájárulástól. Ha soha nem
állították be, az értéke null.

**created\_at** `string` *required*

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

**updated\_at** `string`

A legutóbbi frissítés ISO 8601 időbélyege. Null, ha a profilt még soha nem frissítették.

> [!NOTE]
>
> A `first_name`, `last_name`, `sex`, `date_of_birth` és `profile_group` mezők kötelezőek profil
> létrehozásakor. Minden más mező opcionális. A régi `profile_group_slug` mező továbbra is
> elfogadott a `profile_group` elavult aliasaként.

### Hagyd, hogy a páciens adja meg a születési dátumát és a nemét

Bekapcsolhatunk egy beállítást a profilcsoportodhoz. Így `date_of_birth` és `sex` nélkül is
létrehozhatsz profilt. Kérd tőlünk a bekapcsolását. Enélkül minden olyan létrehozás, amely bármelyik
mezőt kihagyja, `400` hibakódot ad vissza.

A páciens mindkettőt a tesztkészlet aktiválási oldalán (`anivahealth.com/activate`) adja meg, a
tesztkészlet kódjával együtt. Az oldal kétszer kéri be a születési dátumot, mert a laboratórium
később nem tudja módosítani. Ezután a tesztkészlet csak ezzel a születési dátummal nyitható meg.
Amíg a páciens nem adja meg mindkettőt, visszatartjuk a laboratóriumi rendelést. Ezt a beállítást
csak otthoni tesztkészleteknél használd.

## Életciklus

A profilok egyszerű életciklust követnek:

1. **Létrehozás** — regisztráld a profilt a kötelező demográfiai mezőkkel és egy `profile_group` értékkel (UUID
   vagy slug).
2. **Frissítés** (opcionális) — adj hozzá vagy módosíts mezőket, például a `phone`, `height` vagy `weight` mezőt.
3. **Összekapcsolás** — kapcsold össze a profilt időpontokkal úgy, hogy az `id` értékét adod meg `profile_id`-ként.

Egy `profile.*` [webhook](https://docs.anivahealth.com/hu/concepts/webhooks.md) jelzi, ha egy profil létrejön, módosul vagy törlődik.

## Példaprofil

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "handle": "jdoe42",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane.doe@example.com",
  "phone": "+14155552671",
  "sex": 2,
  "date_of_birth": "1990-06-15",
  "height": 168.0,
  "weight": 65.0,
  "language": "en",
  "transactional_emails_enabled": true,
  "created_at": "2026-03-01T09:00:00Z",
  "updated_at": "2026-03-10T14:32:00Z"
}
```


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