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

# Tekil biyobelirteç ekle

> Evde test kiti siparişine tekil biyobelirteçler ekle

Mevcut bir evde test kiti siparişine, herhangi bir hazır panelin dışında bir veya daha fazla tekil biyobelirteç ekle. Bu uç nokta idempotenttir — önceden eklenmiş biyobelirteçler korunur.

`home_kit_orders_manage` kapsamını ve
`home_kit_orders_individual_biomarker_selection` yetenek kapsamını gerektirir. Evde test kitleri panele göre sipariş edilir,
bu yüzden tekil belirteçler iş ortağı bazında etkinleştirilir. Entegrasyonunun buna ihtiyacı varsa Aniva'ya sor.

> [!WARNING]
>
> Biyobelirteçler yalnızca kit `pending` durumundayken eklenebilir. Kit `dispatched` olduğunda
> bileşimi kilitlenir ve bu çağrı `409 Conflict` döndürür — fiziksel kit, seçilen panellere ve biyobelirteçlere
> göre belirlenen sabit sayıda tüple gönderilir; bu nedenle gönderildikten sonra içeriği
> değiştirilemez. `activated` ve `cancelled` kitler de benzer şekilde kilitlidir. Kilitli bir kitteki
> testleri değiştirmen gerekirse doğrudan Aniva'ya ulaş — bu genellikle hâlâ mümkündür ve
> kitin içeriğini tutarlı tutmak için değişikliği senin adına yaparız.

## İstek

### Yol parametreleri

**id** `string` *required*

Biyobelirteç eklenecek evde test kiti siparişinin benzersiz kimliği (UUID).

### Gövde parametreleri

**biomarker\_ids** `integer[]` *required*

Evde test kiti siparişine eklenecek biyobelirteç kimlikleri dizisi. En az bir öğe içermelidir. Biyobelirteç
kimliklerini bulmak için `home_kit=true` ile [Biyobelirteçleri listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) uç noktasını kullan.

## Yanıt

Başarılı olduğunda API, biyobelirteçlerin eklendiğini onaylayan `200 OK` döndürür.

**success** `boolean`

Biyobelirteçler evde test kiti siparişine başarıyla eklendiğinde `true`.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Doğrulama hatası — örn. `biomarker_ids` boş veya geçersiz bir değer içeriyor. |
| `403` | Yasak — `home_kit_orders_manage` veya `home_kit_orders_individual_biomarker_selection` yetenek kapsamı eksik ya da evde test kiti siparişi izin kapsamının dışında. |
| `404` | Evde test kiti siparişi veya bir ya da daha fazla biyobelirteç bulunamadı. |
| `409` | Çakışma — kit `dispatched`, `activated` veya `cancelled` durumunda; panel ve biyobelirteç bileşimi kilitli ve artık değiştirilemez. |
| `500` | İç sunucu hatası. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/biomarkers \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [42, 87]
  }'
```

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

```json 404 theme={null}
{
  "error": "Biomarkers not found: 87"
}
```


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