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

# Panel ekle

> Bir randevuya kan tahlili panelleri ekle

Mevcut bir randevuya bir veya daha fazla kan tahlili paneli ekle. Kan almayı onaylamadan önce panel seçimini oluşturmak için bu uç noktayı birden fazla kez çağırabilirsin.

`appointments_schedule` kapsamını gerektirir.

> [!WARNING]
>
> [Kan almayı onayla](https://docs.anivahealth.com/tr/api/appointments/confirm-blood-draw.md) çağrısını yaptıktan sonra panel
> eklenemez. Onaylanmış bir randevuya panel eklemeye çalışmak `409 Conflict` döndürür.

Kapiler kan almada (`draw_method: capillary`), alınan kan mikrotüplere doldurulur. Önce paneller,
rezervasyon sırasına göre yerleştirilir. Ardından bireysel biyobelirteçler, panel mikrotüplerindeki boş
alanı doldurur. Daha fazla alana ihtiyaç duyduklarında yeni mikrotüpler açılır. Bunları eşit olarak
dağıtırız. Her mikrotüp en fazla 150 µl bireysel biyobelirteç alır. Oluşan panel kümesi bu kuralı bozarsa
çağrı bir `error` mesajıyla `400` döndürür ve hiçbir panel eklenmez.

## İstek

### Yol parametreleri

**id** `string` *required*

Panel eklenecek randevunun benzersiz kimliği (UUID).

### Gövde parametreleri

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

Randevuya eklenecek panel UUID'leri dizisi. En az bir öğe içermelidir.

## Yanıt

Başarılı olduğunda API, panellerin eklendiğini onaylayan `200 OK` yanıtını döndürür.

**success** `boolean`

Paneller randevuya başarıyla eklendiğinde `true`.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Doğrulama hatası — örneğin `panel_ids` boş veya geçersiz bir UUID içeriyor — ya da kapiler kan almada bireysel biyobelirteçler artık mikrotüplerine sığmıyor. |
| `403` | Yasak — API anahtarının bu işleme erişimi yok. |
| `404` | Randevu veya bir ya da daha fazla panel bulunamadı. |
| `409` | Çakışma — kan alma onaylandıktan sonra panel eklenemez veya panellerden biri evde test kitidir (`error_name: "home_kit_appointment_mismatch_error"`). Evde test kitini [evde test kiti siparişi](https://docs.anivahealth.com/tr/api/home-kit-orders/create-home-kit.md) olarak sipariş et. |
| `500` | Dahili sunucu hatası. |

### Evde test kiti paneli

Evde test kiti hastaya gönderilir ve randevuda kan alınmaz. `panel_ids` içindeki bir panel evde test
kitiyse çağrı `409` döndürür ve hiçbir panel eklemez. Gövde şu alanları içerir:

**error** `string`

İnsan tarafından okunabilir neden.

**error\_name** `string`

Her zaman `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Panelin eklenmediği randevu.

**panel\_id** `string`

Evde test kiti paneli.

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

Panelin evde test kiti sağlayıcısı veya bilinmiyorsa `null`.

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