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

# Randevu planla

> Adım adım rehber: Aniva API'siyle bir test noktası bul, müsaitliği kontrol et ve kan alma randevusu al.

Bir test konumu bulmak, bir hasta profili için randevu oluşturmak ve uygulanacak test panellerini eklemek için bu kılavuzu kullan. Hasta kan alma için gelmeden önce bu adımları tamamla.

**1. Uygun konumlara göz at**

`/api/v1/locations` adresine bir `GET` isteği göndererek hesabında kullanılabilir olan test konumlarının listesini al.

```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();
```

Yanıt, konum nesnelerinden oluşan bir dizidir:

```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]
>
> `scheduled_at` zaman damganı oluştururken konum nesnesindeki `timezone` alanını kullan. Randevu saatini konumun yerel saat dilimine dönüştürmek, çalışma saatleri dışında randevu planlamanı önlemeye yardımcı olur.

> [!WARNING]
>
> Randevu alınabilecek saatleri yalnızca `open_hours` alanından çıkarma. [Uygunluğu al](https://docs.anivahealth.com/tr/api/locations/get-availability.md) uç noktasını çağır ve döndürdüğü bir zaman dilimi başlangıcına randevu al — bu çizelge mevcut randevuları, tarihe özel istisnaları ve minimum bildirim süresini de hesaba katar.

**2. Randevuyu oluştur**

Profil ID'si, konum ID'si ve istediğin randevu saatiyle `/api/v1/appointments` adresine bir `POST` isteği gönder. Saat, [Uygunluğu al](https://docs.anivahealth.com/tr/api/locations/get-availability.md) yanıtından dönen bir zaman dilimi başlangıcı olmalıdır.

> [!NOTE]
>
> `scheduled_at`, ISO 8601 formatında gelecekteki bir tarih ve saat olmalıdır; örneğin `2026-05-12T07:30:00Z`. Geçmişteki zaman damgaları ve Aniva tarafından işletilen konumlardaki [12 saatlik minimum bildirim süresi](https://docs.anivahealth.com/tr/api/appointments/create-appointment.md#minimum-bildirim-sueresi) içindeki saatler `400` hatasıyla reddedilir.

> [!TIP]
>
> Bu isteği tekrarlamak güvenlidir. Bir profil aynı konum ve saat için yalnızca bir randevu alabilir; bu nedenle yeniden veya iki kez gönderilen oluşturma isteği hastaya iki kez randevu vermek yerine mevcut `appointment_id` ile `409` döndürür.

```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();
```

Başarılı bir istek, randevu nesnesiyle birlikte `201 Created` döndürür:

```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": []
}
```

Randevu `id` değerini kaydet — panel eklemek ve kan almayı onaylamak için buna ihtiyacın olacak.

**3. Test panellerini ekle**

`/api/v1/appointments/{id}/panels` adresine bir `POST` isteği göndererek kan örneği üzerinde çalıştırmak istediğin test panellerini ekle.

Panel ID'leri UUID formatındadır. API anahtarının sipariş edebileceği panelleri almak için [Panelleri listele](https://docs.anivahealth.com/tr/api/panels/list-panels.md) uç noktasını çağır.

> [!WARNING]
>
> Kan alma onaylandıktan sonra panel eklenemez. Gerekli tüm panelleri onaydan önce ekle — ayrıntılar için [Kan almayı onayla](https://docs.anivahealth.com/tr/guides/confirm-blood-draw.md) kılavuzuna bak.

```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();
```

Başarılı bir istek, panellerin eklendiğini onaylayarak `200 OK` döndürür:

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

## Yeniden planlama veya iptal etme

Bir randevu oluşturduktan sonra, kan alma onaylanmadan önce randevuyu hâlâ değiştirebilirsin:

* **Yeniden planla veya konumu değiştir** — Güncellenecek alanlarla `/api/v1/appointments/{id}` adresine bir `PATCH` isteği gönder. [Randevuyu güncelle](https://docs.anivahealth.com/tr/api/appointments/update-appointment.md) sayfasına bak.
* **İptal et** — `/api/v1/appointments/{id}` adresine bir `DELETE` isteği gönder. [Randevuyu iptal et](https://docs.anivahealth.com/tr/api/appointments/cancel-appointment.md) sayfasına bak.

> [!NOTE]
>
> Her iki işlem de yalnızca kan almadan önce — yani randevu `pending` veya `confirmed`
> durumundayken kullanılabilir. Randevu `blood_drawn` durumuna geçtikten sonra başka
> değişiklik yapılamaz.

## Hata yönetimi

| Durum | Neden | Çözüm |
| - | - | - |
| `400 Bad Request` | Zorunlu bir alan eksik, `scheduled_at` geçmişte, zaman çizelgesinde değil veya 12 saatlik minimum bildirim süresi içinde ya da `panel_ids` boş. | Doğrulama mesajı için hata gövdesini kontrol et ve isteği düzelt. Minimum bildirim süresi için [Uygunluğu al](https://docs.anivahealth.com/tr/api/locations/get-availability.md) yanıtından daha ileri bir zaman dilimi seç. |
| `403 Forbidden` | API anahtarının bu işleme erişimi yok. | API anahtarı izinlerini doğrulamak için Aniva ile iletişime geç. |
| `404 Not Found` | `profile_id` veya `location_id` mevcut değil ya da panel eklerken randevu ID'si geçersiz. | ID'lerin doğru olduğunu ve hesabına ait olduğunu doğrula. |
| `409 Conflict` | Zaten `blood_drawn` veya `cancelled` durumundaki bir randevuya panel eklemeye veya randevuyu değiştirmeye çalıştın. | Onaydan sonra başka değişiklik yapılamaz. |
| `409 Conflict` | Bu profilin o konumda ve saatte zaten bir randevusu var veya zaman dilimi dolu. | Yinelenen durumda mevcut `appointment_id` döndürülür — yeniden denemek yerine o randevuyu kullan. Aksi halde başka bir zaman dilimi seç. |


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