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

> Bir randevuya tekil biyobelirteçler ekle

Bir randevuya herhangi bir hazır panelin dışında, tekil testler olarak bir veya daha fazla bireysel
biyobelirteç ekle. Yönlendirme kararları, her biyobelirtecin laboratuvar bazlı eşleştirmelerine göre
sipariş-lojistik akışı tarafından sonraki aşamada verilir.

Oluşan küme, her laboratuvarın kapalılık kurallarına göre eşzamanlı olarak doğrulanır. Bazı
biyobelirteçler yalnızca diğerleriyle birlikte sipariş edilerek alınabilir — örneğin LDL/HDL oranı,
LDL ve HDL'yi de döndüren bir siparişle sağlanır; dolayısıyla oranı tek başına istemek tutarlı bir
sipariş değildir. (Oran da tam olarak bu bileşenler üzerinden *fiyatlandırılır* — [Biyobelirteçleri
listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) sayfasındaki `pricing` dökümüne bak.) Küme sorunsuz
şekilde sipariş edilemediğinde çağrı bir `validation` verisiyle birlikte `400` döndürür ve **hiçbir şey
kaydedilmez**; böylece deneme yanılmayla geçerli bir kümeye ulaşabilirsin:

1. `PATCH … { "biomarker_ids": [45] }` (yalnızca LDL/HDL oranı) → `400`;
   `validation.failures[].fix_options[].add_biomarkers` LDL ve HDL'yi listeler.
2. `PATCH … { "biomarker_ids": [45, 43, 42] }` (oran + LDL + HDL) → `200`.

Aynı döngü, Aniva'nın yalnızca bir pozisyon içinde sattığı biyobelirteçler için de geçerlidir: bunlardan
birini tek başına istediğinde çağrı, `error: "biomarker_requires_position"` ve bunu satan pozisyonlarla
birlikte `400` döndürür. [Fiyatlandırma](https://docs.anivahealth.com/tr/concepts/pricing.md) sayfasına bak.

[Biyobelirteçleri listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) bazı biyobelirteçleri `price_cents: null`
olarak gösterir. Bu biyobelirteçler **düzenlenmemiştir**: Aniva bunları fiyatlandırmamıştır. Bunlardan
birini eklersen çağrı `error: "biomarker_not_priced"` ile `400` döndürür. Başka hiçbir biyobelirteç bu
hatayı düzeltmez; çünkü `null`, belirteci satın alabileceğin bir fiyat olmadığı anlamına gelir. Kit
belirteçleri istisnadır. Kit olan paneli eklediğinde üyeleri de panelle birlikte gelir. Çağrı, o paneli
zaten içeren bir randevuya eklediğin bir üyeyi de kabul eder.

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. Kendi başına bir mikrotüpte 150 µl'den
fazla hacim gerektiren bir biyobelirteç hiçbir zaman sığmaz; tanımlı hacmi olmayan bir biyobelirteç de
öyle. Oluşan küme bu kuralı bozarsa çağrı bir `error` mesajıyla `400` döndürür ve hiçbir şey kaydedilmez.

Bu çağrı idempotenttir: randevuda zaten bulunan biyobelirteçler korunur.

`appointments_schedule` ve `schedule_appointments_with_individual_biomarker_selection` kapsamlarını gerektirir.

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

## İstek

### Yol parametreleri

**id** `string` *required*

Randevunun benzersiz kimliği (UUID).

### Gövde parametreleri

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

Eklenecek biyobelirteç ID'leri dizisi. En az bir öğe içermelidir. ID'leri bulmak için
[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` yanıtını döndürür.

**success** `boolean`

Biyobelirteçler randevuya başarıyla eklendiğinde `true`.

### `400` yanıtını okuma

Her kapalılık doğrulaması ve katalog `400` hatası `message` alanında bir cümle taşır. Gövde doğrulaması
veya mikrotüp `400` hatası yalnızca `error` alanını taşır. Dallanmayı `error` üzerinden yap. Kapalılık
doğrulaması hatasında `error` bir cümledir. Katalog hatasında `error` bir makine kodudur:
`biomarker_not_priced` veya `biomarker_requires_position`.

**Kapalılık doğrulaması** — küme hiçbir laboratuvarda sorunsuz şekilde sipariş edilemez:

* `validation.failures[]` — yalnızca kapalılık doğrulaması hatalarında bulunur (düz gövde
  doğrulaması hatalarında yer almaz). Hiçbir laboratuvarın sunamadığı her biyobelirteç grubu için
  başarısız olan `biomarker_ids` değerlerini ve en küçük seçenekten başlayarak `fix_options[]`
  dizisini taşıyan bir girdi içerir. Her seçeneğin `add_biomarkers` (`{ id, name }`) alanı, TAMAMINI
  eklemen gereken bir kümedir — mevcut seçimlerini koru, bunları ekle ve yeniden dene. Boş bir
  `fix_options`, hiçbir eklemenin işe yaramayacağı anlamına gelir; bunun yerine biyobelirteci kaldır.

**Fiyatlandırılmamış biyobelirteç** — Aniva bu biyobelirteci fiyatlandırmamıştır. [Biyobelirteçleri
listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) bunu `price_cents: null` olarak gösterir veya
fiyatlandırılmamış bir bileşene sahip bir oransa bunu dahil etmez. `error` değeri `biomarker_not_priced`
olur ve `biomarker_id` ilgili belirteci belirtir. Başka hiçbir biyobelirteç bu hatayı düzeltmez; bu
yüzden biyobelirteci kaldır. Bir biyobelirteci sipariş edilebilir kılan iki koşul vardır: Aniva'nın
yönlendirebileceği bir laboratuvar bunu sunmalıdır **ve** Aniva kataloğu bunu fiyatlandırmış olmalıdır.

**Kısıtlı biyobelirteç** — yalnızca bir pozisyon içinde satılan ve kümede kendisini kapsayan bir
pozisyon bulunmayan biyobelirteç. `error` değeri `biomarker_requires_position` olur, `biomarker_id`
ilgili belirteci belirtir ve `positions[]` bunu satan tüm pozisyonları en ucuzundan başlayarak listeler.
Bunlardan birinin tüm biyobelirteçlerini ekle. Model için [Fiyatlandırma](https://docs.anivahealth.com/tr/concepts/pricing.md) sayfasına,
bir pozisyonun tüm üye kümesi içinse [Biyobelirteç getir](https://docs.anivahealth.com/tr/api/biomarkers/get-biomarker.md) sayfasındaki
`pricing.positions` alanına bak.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | `biomarker_ids` boş / tam sayı değil, küme kapalılık doğrulamasından geçemiyor (`validation.failures`), Aniva'nın fiyatlandırmadığı bir biyobelirteç ekleniyor (`error: "biomarker_not_priced"`), kümedeki hiçbir pozisyonun kapsamadığı kısıtlı bir biyobelirteç bulunuyor (`error: "biomarker_requires_position"`) veya kapiler kan almada biyobelirteçler mikrotüplerine sığmıyor. |
| `403` | Yasak — eksik kapsam veya erişim bağlamı dışındaki randevu. |
| `404` | Randevu veya bir ya da daha fazla biyobelirteç bulunamadı. |
| `409` | Çakışma — kan alma onaylandıktan sonra biyobelirteçler değiştirilemez. |
| `500` | Dahili sunucu hatası. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/biomarkers \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [45, 43, 42]
  }'
```

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

```json 400 (closure validation) theme={null}
{
  "error": "LDL / HDL Ratio cannot be ordered cleanly with this set — add LDL Cholesterol / HDL Cholesterol (see validation.failures for every option).",
  "message": "LDL / HDL Ratio cannot be ordered cleanly with this set — add LDL Cholesterol / HDL Cholesterol (see validation.failures for every option).",
  "validation": {
    "failures": [
      {
        "biomarker_ids": [45],
        "fix_options": [
          {
            "add_biomarkers": [
              { "id": 43, "name": "LDL Cholesterol" },
              { "id": 42, "name": "HDL Cholesterol" }
            ]
          }
        ]
      }
    ]
  }
}
```

```json 400 (biomarker Aniva has not priced) theme={null}
{
  "error": "biomarker_not_priced",
  "message": "Adrenaline, 24h urine carries no price in the catalog you can order from — GET /api/v1/biomarkers/1465 reports price_cents: null for it, and a marker with no price cannot be ordered.",
  "biomarker_id": 1465
}
```

```json 400 (biomarker sold only inside a position) theme={null}
{
  "error": "biomarker_requires_position",
  "message": "Mean Platelet Volume (MPV) is not sold on its own — it comes only inside a position. Add every biomarker of one of the positions listed here; the cheapest is \"Blood Count (extended)\".",
  "biomarker_id": 77,
  "positions": [
    {
      "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
      "name": "Blood Count (extended)",
      "price_cents": 460,
      "retail_cents": 529
    }
  ]
}
```

```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": "Individual biomarkers cannot be modified after blood draw has been confirmed"
}
```

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


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