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

# Gyors kezdés

> Indítsd el az első Aniva Partner API-hívásodat percek alatt: keress vizsgálati helyszínt, hozz létre egy profilt, és foglalj vérvételt.

Ez az útmutató végigvezet az alapvető munkafolyamaton: vizsgálati helyszín keresése, páciensprofil létrehozása, időpontfoglalás és vérvétel megerősítése.

## Előfeltételek

Az Aniva által kiállított partneri API-kulcsra van szükséged.

> [!NOTE]
>
> Ha még nincs API-kulcsod, lépj kapcsolatba az Anivával, hogy kiállítsanak egyet a partnerfiókodhoz.

## Lépések

**1. Elérhető helyszínek listázása**

Kérd le a vizsgálati helyszínek listáját, hogy megtaláld a foglalni kívánt időponthoz szükséges `location_id` értéket.

```bash theme={null}
curl https://anivahealth.com/api/v1/locations \
  -H "x-api-key: YOUR_API_KEY"
```

**Példaválasz**

```json theme={null}
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Unter den Linden",
    "house_number": "42",
    "address_line_2": null,
    "city": "Berlin",
    "state": "Berlin",
    "postal_code": "10117",
    "country_name": "Germany",
    "country_code": "DE",
    "timezone": "Europe/Berlin",
    "contact_phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": null,
    "image_url": null,
    "open_hours": {
      "monday": [{ "open": "08:00", "close": "18:00" }],
      "tuesday": [{ "open": "08:00", "close": "18:00" }],
      "wednesday": [{ "open": "08:00", "close": "18:00" }],
      "thursday": [{ "open": "08:00", "close": "18:00" }],
      "friday": [{ "open": "08:00", "close": "16:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

Jegyezd fel a használni kívánt helyszín `id` értékét. A 3. lépésben szükséged lesz rá.

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

Hozz létre egy páciensprofilt a demográfiai adatok elküldésével. A `profile_group` köti a profilt a partnerfiókodhoz — a csoport megváltoztathatatlan UUID-ját és az olvasható slugját egyaránt elfogadja.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/profiles \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jordan",
    "last_name": "Rivera",
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "profile_group": "your-profile-group"
  }'
```

**A kérés törzsének mezői**

| Mező | Típus | Kötelező | Leírás |
| - | - | - | - |
| `first_name` | string | Igen | A páciens keresztneve |
| `last_name` | string | Igen | A páciens vezetékneve |
| `sex` | integer | Igen\*\* | `1` = férfi, `2` = nő (ISO/IEC 5218) |
| `date_of_birth` | string | Igen\*\* | Születési dátum `YYYY-MM-DD` formátumban. Múltbeli dátumnak kell lennie, nem lehet 1900 előtti, és 16–100 éves életkort kell eredményeznie. |
| `profile_group` | string | Igen\* | A partneri profilcsoportod UUID-ja vagy slugja. Az UUID a stabil hivatkozás; a slug is elfogadott. |
| `profile_group_slug` | string | Nem | **Elavult.** A `profile_group` slug aliasa. A `profile_group` vagy a `profile_group_slug` megadása kötelező. |
| `email` | string | Nem | A páciens e-mail-címe. Ha kimarad, automatikusan generálódik. |
| `language` | string | Nem | `en`, `de` vagy `fi`. Alapértelmezett: `en`. |
| `phone` | string | Nem | Telefonszám E.164 formátumban, például `+4915123456789`. |
| `height` | number | Nem | Testmagasság centiméterben. |
| `weight` | number | Nem | Testsúly kilogrammban. |
| `transactional_emails_enabled` | boolean | Nem | Felülírja a profilcsoport alapértelmezését a működési e-mailek esetében. |
| `marketing_emails_enabled` | boolean | Nem | Felülírja a profilcsoport alapértelmezését a marketing e-mailek esetében. |

\*\* Opcionális, ha a profilcsoportod lehetővé teszi, hogy a páciens mindkettőt megadja a tesztkészlet aktiválási oldalán. Lásd:
[Profilok](https://docs.anivahealth.com/hu/concepts/profiles.md#hagyd-hogy-a-paciens-adja-meg-a-szueletesi-datumat-es-a-nemet).

**Példaválasz (201 Created)**

```json theme={null}
{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "handle": null,
  "first_name": "Jordan",
  "last_name": "Rivera",
  "email": "jordan.rivera@example.com",
  "phone": null,
  "sex": 1,
  "date_of_birth": "1990-04-15",
  "height": null,
  "weight": null,
  "language": "en",
  "transactional_emails_enabled": null,
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": null
}
```

Jegyezd fel a válaszban kapott `id` értéket. A következő lépésben ezt fogod használni `profile_id`-ként.

**3. Időpont foglalása**

Hozz létre egy időpontot a 2. lépésben kapott `profile_id` és az 1. lépésben kapott `location_id` használatával. Állítsd be a `scheduled_at` mezőt egy olyan idősáv kezdetére, amelyet az [Elérhetőség lekérése](https://docs.anivahealth.com/hu/api/locations/get-availability.md) végpont ad vissza az adott helyszínre. Az API elutasítja azokat a kezdési időket, amelyek nem illeszkednek az idősávrendszerbe.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "scheduled_at": "2026-04-10T09:00:00Z"
  }'
```

**Példaválasz (201 Created)**

```json theme={null}
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "scheduled_at": "2026-04-10T09:00:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T10:05:00Z",
  "updated_at": null,
  "profile": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "handle": null,
    "first_name": "Jordan",
    "last_name": "Rivera",
    "email": "jordan.rivera@example.com",
    "phone": null,
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "en",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T10:00:00Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Jegyezd fel az időpont `id` értékét. Erre lesz szükséged a vérvétel megerősítéséhez.

**4. Vérvétel megerősítése**

A vérvétel befejezése után küldd el a laborkódot (a cső vonalkódját) a vérvétel megerősítéséhez és a laborrendelési folyamat elindításához. Ha a vérvétel csövein több kód szerepel, küldd helyette a `lab_codes` mezőt — lásd: [Vérvétel megerősítése](https://docs.anivahealth.com/hu/api/appointments/confirm-blood-draw.md).

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments/c3d4e5f6-a7b8-9012-cdef-123456789012/confirm \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lab_code": "7642001234"
  }'
```

**Példaválasz (200 OK)**

```json theme={null}
{
  "success": true
}
```

A megerősítés után elindul a laborrendelési folyamat. Az időpont lekérésével ellenőrizheted, hogy az állapota `"blood_drawn"` értékre változott-e.

## Következő lépések

* [Adj hozzá paneleket egy időponthoz](https://docs.anivahealth.com/hu/api/appointments/add-panels.md), hogy megadd, mely laborvizsgálatokat kell elvégezni.
* [Módosíts egy időpontot](https://docs.anivahealth.com/hu/api/appointments/update-appointment.md) az átütemezéshez vagy a helyszín megváltoztatásához a vérvétel előtt.
* [Mondj le egy időpontot](https://docs.anivahealth.com/hu/api/appointments/cancel-appointment.md), ha már nincs rá szükség.
* [Kérd le a laboreredményeket](https://docs.anivahealth.com/hu/api/appointments/get-results.md), hogy elérd a klinikai és genetikai eredményeket a feldolgozás után.
* [Tölts le dokumentumokat](https://docs.anivahealth.com/hu/api/documents/download-document.md) a laborleletek PDF-fájljainak lekéréséhez.
* [Kérj le egy profilt](https://docs.anivahealth.com/hu/api/profiles/get-profile.md) a páciens adatainak ellenőrzéséhez vagy megjelenítéséhez.
* Nézd át a teljes [API-referenciát](https://docs.anivahealth.com/hu/api/profiles/create-profile.md) az összes elérhető végpont és paraméter megtekintéséhez.


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