> ## 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 oluştur

> Bir profil için test noktasında kan alma randevusu planla

Belirli bir test konumunda bir hasta profili için kan alma randevusu planla. Randevu oluşturulduğunda varsayılan olarak `confirmed` durumuna geçer (bazı konumlar bunun yerine varsayılan olarak `pending` kullanabilir — bu konuma özel bir ayardır). [Kan almayı onaylamadan](https://docs.anivahealth.com/tr/api/appointments/confirm-blood-draw.md) önce kan tahlili panellerini eklemek için [Panel ekle](https://docs.anivahealth.com/tr/api/appointments/add-panels.md) uç noktasını kullan.

> [!NOTE]
>
> Bir profil aynı konum ve saat için en fazla **bir** randevu alabilir. Profilin zaten randevusunun
> olduğu bir zaman dilimi için randevu oluşturmak, ikinci bir randevu yerine mevcut `appointment_id`
> ile `409` döndürür — böylece yeniden denenen veya yanlışlıkla tekrarlanan bir istek asla çift
> randevu oluşturmaz. [Yinelenen randevular](#yinelenen-randevular) bölümüne bak.

Bu oluşturma işlemini güvenle yeniden denenebilir kılmak için isteğe bağlı bir `Idempotency-Key` başlığı gönder — aynı anahtarın tekrarı ikincisini oluşturmak yerine ilk yanıtı döndürür. [İdempotans](https://docs.anivahealth.com/tr/concepts/idempotency.md) bölümüne bak.

`appointments_schedule` kapsamını gerektirir.

## İstek

### Gövde parametreleri

**profile\_id** `string` *required*

Randevunun oluşturulacağı hasta profilinin UUID'si.

**location\_id** `string` *required*

Kan almanın yapılacağı test konumunun UUID'si. Mevcut konum ID'lerini bulmak için
[Konumları listele](https://docs.anivahealth.com/tr/api/locations/list-locations.md) uç noktasını kullan.

**scheduled\_at** `string` *required*

Randevunun ISO 8601 biçimindeki tarih ve saati (ör. `2026-05-15T10:30:00Z` veya
`2026-05-15T12:30:00+02:00`). **Saat dilimi göstergesi içermelidir** — `Z` veya `+02:00` gibi
açık bir fark belirtilmelidir; saat dilimi olmayan tarih-saat değerleri reddedilir. Gelecekte bir
zaman olmalıdır.

Konumun zaman çizelgesindeki tam bir zaman dilimi başlangıcı olmalı ve zaman diliminde hâlâ
kontenjan bulunmalıdır — önce [Müsaitliği getir](https://docs.anivahealth.com/tr/api/locations/get-availability.md) yanıtını oku.
Çizelge dışı saatler `400`, dolmuş bir zaman dilimi `409` döndürür. Aniva'nın işlettiği konumlarda
ayrıca en az 12 saat sonrası olmalıdır — [Minimum bildirim süresi](#minimum-bildirim-sueresi) bölümüne bak.

**results\_ready\_emails** `string[]`

Tüm laboratuvar sonuçları kesinleştiğinde her biri bir e-posta alacak en fazla 5 adres. E-posta,
Aniva yönetim panelindeki sonuç sayfasına yönlendirir. Anahtarının hasta için `results_view`
erişimine sahip olması gerekir, aksi halde `403` döner. Hastanın grubu için ayarlanan varsayılan
adresleri kullanmak için bu alanı gönderme. Boş bir liste e-postaları kapatır.
[Sonuçlar hazır e-postaları](https://docs.anivahealth.com/tr/concepts/results.md#sonuclar-hazir-e-postalari) bölümüne bak.

**draw\_method** `string`

Kanın nasıl alınacağı: `capillary` veya `venous`. Konumun `default_draw_method` değerini kullanmak
için bu alanı gönderme. Konumun bu yöntemi `draw_methods` listesinde barındırması gerekir, aksi
halde `400` döner.

## Yanıt

Başarılı olduğunda API, yeni randevuyla birlikte `201 Created` döndürür.

**id** `string` *required*

Benzersiz randevu tanımlayıcısı (UUID).

**profile\_id** `string` *required*

Bu randevunun ait olduğu profilin UUID'si.

**location\_id** `string`

Kan almanın gerçekleştiği test konumunun UUID'si.

**scheduled\_at** `string`

UTC anı olarak planlanan randevu tarih ve saati (`Z` son ekli ISO 8601, ör.
`2026-05-15T10:30:00Z`). `null` olabilir.

**status** `string` *required*

Mevcut randevu durumu. `pending`, `confirmed`, `blood_drawn` veya `cancelled` değerlerinden biri.
Laboratuvar sonuçlarının tamamlanma ayrıntıları [Sonuçları getir](https://docs.anivahealth.com/tr/api/appointments/get-results.md)
üzerinden; daha ayrıntılı gönderi ilerleyişi ise satır içi `shipments` dizisindeki (aşağıya bak)
her kaydın [Gönderiyi getir](https://docs.anivahealth.com/tr/api/shipments/get-shipment.md) ile takip edilmesiyle elde edilir.

**cancellation\_reason** `string`

Randevu iptal edildiğinde kaydedilen serbest metin neden (ör. gelmeme, geç iptal,
'Başarısız. Tekrar gerekli'). `status` değeri `cancelled` değilse `null` olur.

**results\_ready\_emails** `string[]` *required*

Tüm laboratuvar sonuçları kesinleştiğinde her birine bir e-posta gönderilen, küçük harfe çevrilmiş adresler. Kapalıyken boştur. Bkz.
[Sonuçlar hazır e-postaları](https://docs.anivahealth.com/tr/concepts/results.md#sonuclar-hazir-e-postalari).

**draw\_method** `string` *required*

Kan alma yöntemi: `capillary` (parmak ucundan veya üst koldan, mikrotüplere) ya da `venous` (damardan,
tüplere). Randevuda belirlenen yöntemdir; belirlenmemişse [konumun](https://docs.anivahealth.com/tr/concepts/locations.md)
`default_draw_method` değeridir. Kan almadan sonra kullanılan yöntemdir.

**profile** `object` *required*

Bu randevuyla ilişkili hasta profili.

**profile**

**id** `string`

Benzersiz profil kimliği (UUID).

**handle** `string`

Profil takma adı veya kullanıcı adı. `null` olabilir.

**first\_name** `string`

Ad. `null` olabilir.

**last\_name** `string`

Soyad. `null` olabilir.

**email** `string`

E-posta adresi. `null` olabilir.

**phone** `string`

E.164 biçiminde telefon numarası. `null` olabilir.

**sex** `integer`

ISO/IEC 5218 standardına göre biyolojik cinsiyet. `null` olabilir.

**date\_of\_birth** `string`

`YYYY-MM-DD` biçiminde doğum tarihi. `null` olabilir.

**height** `number`

Santimetre cinsinden boy. `null` olabilir.

**weight** `number`

Kilogram cinsinden kilo. `null` olabilir.

**language** `string`

Tercih edilen dil: [Profil oluştur](https://docs.anivahealth.com/tr/api/profiles/create-profile.md) içindeki 32 koddan biri.

**transactional\_emails\_enabled** `boolean`

Bu profilin işlemsel (programatik) e-postalar alıp almadığı. `null` olabilir.

**panels** `AppointmentPanel[]` *required*

Bu randevuya şu anda bağlı olan paneller. Yeni oluşturulan randevularda boştur —
[Panel ekle](https://docs.anivahealth.com/tr/api/appointments/add-panels.md) ile bağla. Panel ayrıntılarını (ad, biyobelirteçler)
[Panelleri listele](https://docs.anivahealth.com/tr/api/panels/list-panels.md) üzerinden görüntüle.

**Eklenen panel alanları**

**panel\_id** `string`

Panel UUID'si — [Panelleri listele](https://docs.anivahealth.com/tr/api/panels/list-panels.md) ile eşleştir.

**added\_at** `string`

Panelin bu randevuya ilk eklendiği zamanın ISO 8601 zaman damgası.

**individual\_biomarkers** `AppointmentIndividualBiomarker[]` *required*

Herhangi bir panel dışında bu randevuya eklenen tekil biyobelirteçler. Yeni oluşturulan
randevularda boştur — [Tekil biyobelirteç ekle](https://docs.anivahealth.com/tr/api/appointments/add-individual-biomarkers.md) ile
ekle. Görüntüleme verileri için her `biomarker_id` değerini
[Biyobelirteçleri listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) ile eşleştir.

**Tekil biyobelirteç alanları**

**biomarker\_id** `integer`

Biyobelirteç tanımlayıcısı —
[Biyobelirteçleri listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) ile eşleştir.

**added\_at** `string`

Biyobelirtecin bu randevuya ilk eklendiği zamanın ISO 8601 zaman damgası.

**shipments** `AppointmentShipmentLink[]` *required*

Bu randevuya bağlı gönderiler, en eski bağlantı ilk sırada olacak şekilde. Yeni oluşturulan
randevularda boştur — [Gönderi oluştur](https://docs.anivahealth.com/tr/api/shipments/create-shipment.md) (`appointment_id` ile)
veya [Gönderiye randevu bağla](https://docs.anivahealth.com/tr/api/shipments/attach-appointments-to-shipment.md) ile bağla.

**Gönderi bağlantısı alanları**

**id** `string`

Gönderi referans tanımlayıcısı —
[Gönderiyi al](https://docs.anivahealth.com/tr/api/shipments/get-shipment.md) ile eşleştir.

**added\_at** `string`

Gönderinin bu randevuya ilk bağlandığı zamanın ISO 8601 zaman damgası.

**lab\_codes** `string[]` *required*

Bu randevu için tarama sırasına göre kaydedilen laboratuvar kodları (tüp barkodları). Kan alma
onaylanana kadar boştur. Venöz kan almada her tüpe basılı tek bir kod bulunur; kapiler kan almada
mikrotüp başına bir kod bulunur. [Sonuçları al](https://docs.anivahealth.com/tr/api/appointments/get-results.md) üzerindeki sonuçlar ve belgeler
bu kodlara `lab_code` üzerinden başvurur.

## Minimum bildirim süresi

Aniva'nın işlettiği konumlarda randevular en az **12 saat** önceden alınmalıdır; bu süre içinde
randevu almak `400` döndürür. [Müsaitliği getir](https://docs.anivahealth.com/tr/api/locations/get-availability.md) bu zaman
dilimlerini zaten gizler, yani bu çizelgeden okuduğun her zaman dilimi için randevu alınabilir.

Kendi işlettiğin konumlarda minimum bildirim süresi yoktur — aynı gün ve yerinde randevu alma aynı şekilde devam eder.

## Yinelenen randevular

Bir profil aynı konum ve an için iptal edilmemiş en fazla bir randevu tutabilir — konumda kaç
koltuk olursa olsun, aynı kişiden aynı yerde ve aynı anda iki kez kan alınamaz.

Profilin zaten randevusunun olduğu bir zaman dilimi için randevu oluşturmak, mevcut randevuyu
belirten bir `appointment_id` ile `409` döndürür:

```json theme={null}
{
  "error": "This profile already has an appointment at this location and time. Reschedule or cancel the existing appointment instead of creating a second one.",
  "appointment_id": "03e916d2-7fd6-4414-8276-8532a105edc3"
}
```

İsteği zaten uygulanmış kabul ederek ele al: randevuyu
[Randevuyu getir](https://docs.anivahealth.com/tr/api/appointments/get-appointment.md) ile çek,
[Randevuyu güncelle](https://docs.anivahealth.com/tr/api/appointments/update-appointment.md) ile taşı veya
[Randevuyu iptal et](https://docs.anivahealth.com/tr/api/appointments/cancel-appointment.md) ile iptal et. Oluşturma isteğini
yeniden deneme — `409` döndürmeye devam eder.

Bu, tekrarlanan oluşturma isteklerini güvenli kılar: zaman aşımı sonrası yeniden gönderdiğin bir
istek veya iki kez gönderilen bir form, aynı hasta için aynı saatte iki randevu oluşturamaz.

> [!NOTE]
>
> `appointment_id` yalnızca yinelenen randevu `409` yanıtında bulunur. Kontenjan kaynaklı `409` —
> zaman dilimi *diğer* hastalar tarafından doldurulduğu için doluysa — yalnızca `error` döndürür;
> buradaki doğru çözüm [Müsaitliği getir](https://docs.anivahealth.com/tr/api/locations/get-availability.md) üzerinden başka bir zaman
> dilimi seçmektir.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Doğrulama hatası — örn. `scheduled_at` geçmişte, Aniva tarafından işletilen bir konumda 12 saatten daha yakın, konumun saat çizelgesinde tam bir aralık başlangıcı değil veya konum `draw_method` için kap bulundurmuyor. |
| `403` | Yasak — API anahtarının bu işleme erişimi yok veya hasta için `results_view` erişimi olmadan `results_ready_emails` ayarlanmış. |
| `404` | Profil veya konum bulunamadı ya da konum aktif değil. |
| `409` | Bu profilin bu konumda ve saatte zaten bir randevusu var (`appointment_id` içerir), zaman aralığının kapasitesi dolu, konum o tarihte kapalı, `Idempotency-Key` farklı bir gövdeyle yeniden kullanılmış veya ilk isteği henüz tamamlanmamış. |
| `500` | İç sunucu hatası. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T10:30:00Z"
  }'
```

```json 201 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T10:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

```json 400 theme={null}
{
  "error": "Appointments must be booked at least 12 hours in advance. Please pick a later time."
}
```

```json 404 theme={null}
{
  "error": "Location not found or inactive"
}
```

```json 409 theme={null}
{
  "error": "This profile already has an appointment at this location and time. Reschedule or cancel the existing appointment instead of creating a second one.",
  "appointment_id": "03e916d2-7fd6-4414-8276-8532a105edc3"
}
```


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