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

# Időpont foglalása

> Lépésről lépésre útmutató: keress vizsgálati helyszínt, ellenőrizd az elérhetőséget, és foglalj vérvételi időpontot az Aniva API-val.

Ezzel az útmutatóval megkereshetsz egy vizsgálati helyszínt, időpontot hozhatsz létre egy páciensprofilhoz, és hozzárendelheted az elvégzendő tesztpaneleket. Végezd el ezeket a lépéseket, mielőtt a páciens megérkezik a vérvételre.

**1. Elérhető helyszínek böngészése**

Kérd le a fiókodban elérhető vizsgálati helyszínek listáját egy `GET` kéréssel a `/api/v1/locations` végpontra.

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/locations \
  --header 'x-api-key: YOUR_API_KEY'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/locations', {
  headers: {
    'x-api-key': 'YOUR_API_KEY',
  },
});

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

A válasz helyszínobjektumok tömbje:

```json theme={null}
[
  {
    "id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Friedrichstraße",
    "house_number": "112",
    "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": "17:00" }],
      "tuesday": [{ "open": "08:00", "close": "17:00" }],
      "wednesday": [{ "open": "08:00", "close": "17:00" }],
      "thursday": [{ "open": "08:00", "close": "17:00" }],
      "friday": [{ "open": "08:00", "close": "15:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

> [!TIP]
>
> A `scheduled_at` időbélyeg összeállításakor használd a helyszínobjektum `timezone` mezőjét. Ha az időpontot a helyszín helyi időzónájára váltod át, elkerülheted, hogy nyitvatartási időn kívülre foglalj.

> [!WARNING]
>
> Ne csak az `open_hours` alapján határozd meg a foglalható időpontokat. Hívd meg az [Elérhetőség lekérése](https://docs.anivahealth.com/hu/api/locations/get-availability.md) végpontot, és az általa visszaadott idősávok egyikének kezdetére foglalj — ez az idősávrács a meglévő foglalásokat, a dátumhoz kötött kivételeket és a minimális előzetes foglalási időt is figyelembe veszi.

**2. Időpont létrehozása**

Küldj egy `POST` kérést a `/api/v1/appointments` végpontra a profilazonosítóval, a helyszínazonosítóval és a kívánt időponttal. Az időpontnak az [Elérhetőség lekérése](https://docs.anivahealth.com/hu/api/locations/get-availability.md) végpont által visszaadott egyik idősáv kezdetének kell lennie.

> [!NOTE]
>
> A `scheduled_at` értékének jövőbeli, ISO 8601 formátumú dátumnak és időpontnak kell lennie, például `2026-05-12T07:30:00Z`. A múltbeli időbélyegeket a rendszer `400`-as hibával elutasítja, ahogy az Aniva által üzemeltetett helyszíneken a [12 órás minimális előzetes foglalási időn](https://docs.anivahealth.com/hu/api/appointments/create-appointment.md#minimalis-elofoglalasi-ido) belüli időpontokat is.

> [!TIP]
>
> Ennek a kérésnek az ismétlése biztonságos. Egy profilnak helyszínenként és időpontonként csak egy időpontja lehet, így egy újraküldött vagy duplán beküldött létrehozási kérés a páciens kétszeri lefoglalása helyett `409`-es választ ad vissza a meglévő `appointment_id` értékkel.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
    "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "scheduled_at": "2026-05-12T07:30:00Z"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/appointments', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    profile_id: 'a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
    location_id: 'b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421',
    scheduled_at: '2026-05-12T07:30:00Z',
  }),
});

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

Sikeres kérés esetén a válasz `201 Created` az időpontobjektummal:

```json theme={null}
{
  "id": "c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12",
  "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
  "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
  "scheduled_at": "2026-05-12T07:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T11:02:47Z",
  "updated_at": null,
  "profile": {
    "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
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Mentsd el az időpont `id` értékét — szükséged lesz rá a panelek hozzáadásához és a vérvétel megerősítéséhez.

**3. Tesztpanelek hozzáadása**

Rendeld hozzá a vérmintán elvégezni kívánt tesztpaneleket egy `POST` kéréssel a `/api/v1/appointments/{id}/panels` végpontra.

A panelazonosítók UUID-k. Hívd meg a [Panelek listázása](https://docs.anivahealth.com/hu/api/panels/list-panels.md) végpontot, hogy lekérd az API-kulcsoddal rendelhető paneleket.

> [!WARNING]
>
> A vérvétel megerősítése után már nem adhatók hozzá panelek. Minden szükséges panelt a megerősítés előtt adj hozzá — részletekért lásd a [Vérvétel megerősítése](https://docs.anivahealth.com/hu/guides/confirm-blood-draw.md) útmutatót.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "panel_ids": [
      "d1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27",
      "e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38"
    ]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      panel_ids: [
        'd1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27',
        'e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38',
      ],
    }),
  }
);

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

Sikeres kérés esetén a válasz `200 OK`, amely megerősíti a panelek hozzáadását:

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

## Átütemezés vagy lemondás

Az időpont létrehozása után a vérvétel megerősítéséig még módosíthatod azt:

* **Átütemezés vagy helyszínmódosítás** — Küldj egy `PATCH` kérést a `/api/v1/appointments/{id}` végpontra a frissítendő mezőkkel. Lásd: [Időpont frissítése](https://docs.anivahealth.com/hu/api/appointments/update-appointment.md).
* **Lemondás** — Küldj egy `DELETE` kérést a `/api/v1/appointments/{id}` végpontra. Lásd: [Időpont lemondása](https://docs.anivahealth.com/hu/api/appointments/cancel-appointment.md).

> [!NOTE]
>
> Mindkét művelet csak a vérvétel előtt érhető el — vagyis amíg az időpont `pending` vagy
> `confirmed` státuszban van. Amint az időpont `blood_drawn` státuszba kerül, további
> módosítás nem lehetséges.

## Hibakezelés

| Státusz | Ok | Megoldás |
| - | - | - |
| `400 Bad Request` | Egy kötelező mező hiányzik, a `scheduled_at` múltbeli, nem illeszkedik az idősávrácsba, vagy a 12 órás minimális előzetes foglalási időn belül van, illetve a `panel_ids` üres. | Ellenőrizd a hibatörzsben a validációs üzenetet, és javítsd a kérést. A minimális előzetes foglalási idő miatt válassz későbbi idősávot az [Elérhetőség lekérése](https://docs.anivahealth.com/hu/api/locations/get-availability.md) végpontról. |
| `403 Forbidden` | Az API-kulcsodnak nincs jogosultsága ehhez a művelethez. | Vedd fel a kapcsolatot az Anivával az API-kulcsod jogosultságainak ellenőrzéséhez. |
| `404 Not Found` | A `profile_id` vagy a `location_id` nem létezik, vagy panelek hozzáadásakor az időpont-azonosító érvénytelen. | Ellenőrizd, hogy az azonosítók helyesek-e, és a fiókodhoz tartoznak-e. |
| `409 Conflict` | Olyan időponthoz próbáltál paneleket hozzáadni vagy olyan időpontot próbáltál módosítani, amely már `blood_drawn` vagy `cancelled` státuszú. | Megerősítés után további módosítás nem lehetséges. |
| `409 Conflict` | Ennek a profilnak már van időpontja az adott helyszínen és időpontban, vagy az idősáv betelt. | Duplikáció esetén a válasz tartalmazza a meglévő `appointment_id` értéket — újrapróbálkozás helyett használd azt az időpontot. Ellenkező esetben válassz másik idősávot. |


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