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

# Panelek hozzáadása

> Vérvizsgálati panelek hozzáadása egy időponthoz

Adj hozzá egy vagy több vérvizsgálati panelt egy meglévő időponthoz. Ezt a végpontot többször is meghívhatod, hogy a vérvétel megerősítése előtt összeállítsd a kiválasztott paneleket.

Az `appointments_schedule` jogosultsági kör szükséges hozzá.

> [!WARNING]
>
> A [Vérvétel megerősítése](https://docs.anivahealth.com/hu/api/appointments/confirm-blood-draw.md) hívása után már nem adhatók hozzá panelek.
> Ha egy megerősített időponthoz próbálsz paneleket hozzáadni, a hívás `409 Conflict` választ ad.

Kapilláris vérvételnél (`draw_method: capillary`) a minta mikrocsövekbe kerül. Először a panelek kerülnek sorra, a
foglalás sorrendjében. Az egyéni biomarkerek ezután a panelek mikrocsöveiben maradt szabad helyet töltik ki. Ha több
helyre van szükségük, új mikrocsöveket nyitnak. Egyenletesen osztjuk el őket. Egy mikrocsőbe legfeljebb
150 µl egyéni biomarker fér. Ha az így kapott panelhalmaz megszegi ezt a szabályt, a hívás `400`-as választ ad egy
`error` üzenettel, és egyetlen panelt sem ad hozzá.

## Kérés

### Útvonalparaméterek

**id** `string` *required*

Annak az időpontnak az egyedi azonosítója (UUID), amelyhez paneleket adsz hozzá.

### Törzsparaméterek

**panel\_ids** `string[]` *required*

Az időponthoz hozzáadni kívánt panel-UUID-k tömbje. Legalább egy elemet tartalmaznia kell.

## Válasz

Siker esetén az API `200 OK` válasszal erősíti meg, hogy a paneleket hozzáadta.

**success** `boolean`

`true`, ha a panelek hozzáadása az időponthoz sikeres volt.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `400` | Érvényesítési hiba – pl. a `panel_ids` üres vagy érvénytelen UUID-t tartalmaz –, vagy kapilláris vérvételnél az egyéni biomarkerek már nem férnek el a mikrocsövekben. |
| `403` | Tiltott – az API-kulcsod nem rendelkezik hozzáféréssel ehhez a művelethez. |
| `404` | Az időpont vagy egy vagy több panel nem található. |
| `409` | Ütközés – a vérvétel megerősítése után nem adhatók hozzá panelek, vagy egy panel otthoni tesztkészlet (`error_name: "home_kit_appointment_mismatch_error"`). Az otthoni tesztkészletet [otthoni tesztkészlet rendelésként](https://docs.anivahealth.com/hu/api/home-kit-orders/create-home-kit.md) rendeld meg. |
| `500` | Belső szerverhiba. |

### Otthoni tesztkészlet panel

Az otthoni tesztkészletet a páciensnek küldjük ki, és nem egy időpontban történik a vérvétel. Ha a `panel_ids` egyik panelje
otthoni tesztkészlet, a hívás `409`-es választ ad, és egyetlen panelt sem ad hozzá. A válasz törzse ezeket a mezőket tartalmazza:

**error** `string`

Ember által olvasható indoklás.

**error\_name** `string`

Mindig `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Az az időpont, amelyhez a panelt nem adta hozzá.

**panel\_id** `string`

Az otthoni tesztkészlet panel.

**home\_kit\_provider** `string | null`

A panel otthoni tesztkészletének szolgáltatója, vagy `null`, ha nem ismert.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/panels \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": [
      "d4e5f6a7-b8c9-4d1e-a2f3-b4c5d6e7f8a9",
      "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
    ]
  }'
```

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

```json 400 (capillary, does not fit) theme={null}
{
  "error": "Some individual biomarkers need more than 150 µl of one lab's microtainer. Remove some of them."
}
```

```json 409 theme={null}
{
  "error": "Panels cannot be added after blood draw has been confirmed"
}
```

```json 409 (home kit panel) theme={null}
{
  "error": "Panel e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0 is a home kit (biomes) and cannot attach to appointment c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a — order it via home-kit orders",
  "error_name": "home_kit_appointment_mismatch_error",
  "appointment_id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "panel_id": "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0",
  "home_kit_provider": "biomes"
}
```

```json 404 theme={null}
{
  "error": "Panels not found: e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
}
```


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