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

# Profil oluştur

> Yeni bir hasta profili oluştur ve bir profil grubuna ata

Yeni bir hasta profili oluştur ve bunu bir profil grubuna ata. Profil, randevularda ve laboratuvar siparişlerinde kullanılan demografik verileri tutar.

`create_user` kapsamını gerektirir.

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.

## İstek

### Gövde parametreleri

**first\_name** `string` *required*

Hastanın adı. 1 ile 100 karakter arasında olmalı ve Latin karakterleri kullanmalıdır.

**last\_name** `string` *required*

Hastanın soyadı. 1 ile 100 karakter arasında olmalı ve Latin karakterleri kullanmalıdır.
Laboratuvarlar soyadı olmayan bir hasta için verilen siparişleri reddeder, bu nedenle soyadı
olmadan profil oluşturulamaz.

Test verilerini önceden oluşturmak için üç değer ayrılmıştır — bkz. [Sandbox test verileri](#sandbox-test-verileri).

**sex** `integer` *required*

ISO/IEC 5218 standardına göre biyolojik cinsiyet. Erkek için `1`, kadın için `2` kullan.
Laboratuvar referans aralıkları için buna ihtiyaç duyar, bu nedenle `0` (bilinmiyor) değeri `400`
döndürür. Profil grubun hastanın bunu kit etkinleştirme sayfasında girmesine izin vermediği
sürece zorunludur. İzin veriyorsa atla. Bkz.
[Doğum tarihi ve cinsiyeti hastanın girmesine izin ver](https://docs.anivahealth.com/tr/concepts/profiles.md#hastanin-dogum-tarihi-ve-cinsiyeti-girmesine-izin-ver).

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

`YYYY-MM-DD` biçiminde doğum tarihi. Geçmişte olmalı ve 1900'den önce olmamalıdır. Hesaplanan
yaş 16 ile 100 arasında olmalıdır. Diğer değerler `400` döndürür. Profil grubun hastanın bunu kit
etkinleştirme sayfasında girmesine izin vermediği sürece zorunludur. İzin veriyorsa atla.

**profile\_group** `string` *required*

Bu profilin atanacağı profil grubuna yönelik çok biçimli referans (UUID veya slug). UUID
değiştirilemez kimliktir ve slug yeniden adlandırmalarından etkilenmez; slug ise okunabilir
kimlikler üzerine kurulu pazarlama ve iş ortağı entegrasyonları için kabul edilmeye devam eder.
UUID tercih edilir. Profil grubu, API anahtarının erişim bağlamı içinde olmalıdır. Kullanımdan
kaldırılan `profile_group_slug` alanını göndermiyorsan zorunludur.

**profile\_group\_slug** `string` *deprecated*

Kullanımdan kaldırıldı: `profile_group` kullan. Profil grubunun slug değeri. Yalnızca küçük
harfler, rakamlar, tireler ve alt çizgiler.

**email** `string`

Profilin e-posta adresi. Gönderilmezse Aniva otomatik olarak bir e-posta adresi oluşturur.

`email` sağlamak oluşturma işlemini **yeniden denemeye karşı güvenli** kılar: bir adrese yalnızca tek
bir profil bağlı olabilir, bu nedenle tekrarlanan bir istek ikinci bir profil yerine `409` döndürür.
Otomatik oluşturulan adresler her istek için benzersizdir. Entegrasyonun yeniden deneme yapıyorsa
`email` veya bir `Idempotency-Key` gönder.

**phone** `string`

E.164 biçiminde telefon numarası (ör. `+14155552671`).

**height** `number`

Santimetre cinsinden boy.

**weight** `number`

Kilogram cinsinden kilo.

**language** `string` (default: en)

Profil için tercih edilen dil: `en`, `bg`, `ca`, `cs`, `da`, `de`, `el`, `es`, `et`, `fi`, `fr`, `ga`, `hr`, `hu`, `is`, `it`, `lb`, `lt`, `lv`, `mt`, `nl`, `no`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `tr` veya `uk`. Varsayılan olarak `en` kullanılır.

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

Bu profilin işlemsel (programatik) e-postaları — randevu onayları, sonuçların hazır olduğuna dair
bildirimler vb. — alıp almayacağı. Profil grubunun varsayılanını geçersiz kılar. Pazarlama
onayından ayrıdır. Varsayılanı kullanmak için atla.

**marketing\_emails\_enabled** `boolean`

Bu profilin pazarlama e-postalarına (bültenler, ürün güncellemeleri) onay verip vermediği. Profil
grubunun varsayılanını geçersiz kılar. İşlemsel e-postalardan ayrıdır. Profil grubunun
varsayılanını kullanmak için atla. Yalnızca yazılabilir: profil yanıtında döndürülmez.

## Sandbox test verileri

Test etmeye değer her okuma yolu — [Randevuları listele](https://docs.anivahealth.com/tr/api/appointments/list-appointments.md),
[Sonuçları al](https://docs.anivahealth.com/tr/api/appointments/get-results.md),
[Belge indir](https://docs.anivahealth.com/tr/api/documents/download-document.md) — günler sonra gerçek bir kan alma işlemi yapılana
kadar boştur. Bu da otomatik bir entegrasyon testi yazmayı zorlaştırır.

Bunu çözmek için üç `last_name` değeri ayrılmıştır. Bunlardan biriyle bir profil oluştur; Aniva
yanıt vermeden önce aşağıda açıklanan durumu önceden doldurur, böylece bir sonraki çağrın bunu
hazır olarak görür:

| `last_name` | Profile eklenenler |
| - | - |
| `Upcomingtestmann` | Panel bağlı, yaklaşan bir `confirmed` randevu. Henüz sonuç yok. |
| `Partialtestmann` | Geçmiş bir `blood_drawn` randevu. Panelin yaklaşık **yarısı** raporlanmıştır; [Sonuçları al](https://docs.anivahealth.com/tr/api/appointments/get-results.md) `in_progress` durumundadır. |
| `Fulltestmann` | Geçmiş bir `blood_drawn` randevu. Paneldeki **her** biyobelirteç raporlanmıştır, `status: "completed"` ve `documents[]` içinde bir PDF laboratuvar raporu bulunur. |

Eşleştirme büyük/küçük harfe duyarsızdır. `date_of_birth` ve `sex` dahil diğer tüm alanlar normal
şekilde saklanır ve kullanılır; böylece geri aldığın referans aralıkları, oluşturduğun profile ait
gerçek yaş ve cinsiyete özel aralıklardır.

Randevu **Aniva Test** konumunda, bugünden en az beş gün sonraki (veya geçmiş durumlar için beş
gün önceki) gerçekten randevu alınabilir bir zaman dilimine alınır. Bu veriyi oluşturmak
laboratuvar siparişi vermez ve kurye ayarlamaz.

> [!NOTE]
>
> Test profillerine kontrol ettiğin bir adres ver. Aniva'nın randevu hatırlatıcıları
> `scheduled_at` alanına göre çalışır; bu nedenle profil `transactional_emails_enabled: false` ile
> devre dışı bırakılmadığı sürece yaklaşan test verisi bu hatırlatıcıları gönderir.

Panel, API anahtarının görebildiği paneller arasından rastgele seçilir; bu nedenle `panel_id`
değeri her zaman kendi [Panelleri listele](https://docs.anivahealth.com/tr/api/panels/list-panels.md) sonucunla eşleşir. Klinik
biyobelirteçler biyobelirtecin referans aralığı içinde bir değer alır; genler ise Aniva'nın referans verilerinden rastgele bir genotip alır ve eşleşen varyantlar, klinik anlamlılık ile rs ID'leri buna göre belirlenir.

> [!NOTE]
>
> Panel ve değerler her oluşturma işleminde yeniden üretilir; bu nedenle belirli bir panel veya
> kesin sayılar yerine veri yapısını doğrula.

## Yanıt

İşlem başarılı olursa API, yeni oluşturulan profille birlikte `201 Created` döndürür.

**id** `string` *required*

Benzersiz profil kimliği (UUID).

**handle** `string`

Profil tanıtıcısı 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'e göre biyolojik cinsiyet (`0` = bilinmiyor, `1` = erkek, `2` = kadın). `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, yukarıdaki 32 koddan biri.

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

Bu profilin işlemsel (programatik) e-postaları alıp almayacağı. Hiç ayarlanmadığında `null`.

**created\_at** `string`

Profilin oluşturulduğu zamanın ISO 8601 zaman damgası.

**updated\_at** `string`

Son güncellemenin ISO 8601 zaman damgası. Yeni oluşturulan profiller için `null`.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Doğrulama hatası — bir veya daha fazla alan doğrulamadan geçemedi. |
| `403` | Erişim reddedildi — API anahtarının bu işleme erişimi yok veya profil grubu erişim bağlamının dışında. |
| `404` | Profil grubu bulunamadı. |
| `409` | Verilen `email` için (yanıt adresi içerir) veya aynı kişi için (aşağıya bak) zaten bir profil var ya da `Idempotency-Key` farklı bir gövdeyle yeniden kullanıldı veya ilk isteği henüz tamamlanmadı. |
| `500` | Dahili sunucu hatası. |

Bir `409` yanıtı şu şekilde görünür — bunu "bu profil zaten var" şeklinde ele al ve oluşturmayı
yeniden denemek yerine [Profilleri listele](https://docs.anivahealth.com/tr/api/profiles/list-profiles.md) (`?email=`) ile profili ara:

```json theme={null}
{
  "error": "An account with the email \"maria.schmidt@example.com\" already exists.",
  "error_name": "email_exists_error",
  "email": "maria.schmidt@example.com"
}
```

Anahtarının görebildiği bir profille aynı ad, soyad, cinsiyet ve doğum tarihine sahip bir kişi için
`error_name: "duplicate_profile_error"` içeren bir `409` döner. İkinci bir profil oluşturmak
yerine döndürülen `profile_id` değerini kullan:

```json theme={null}
{
  "error": "A patient named \"Maria Schmidt\", born 02-04-1990, with the same biological sex already exists as m***@example.com. Search for that patient and select them instead of creating a duplicate.",
  "error_name": "duplicate_profile_error",
  "profile_id": "3f1c2a8e-5b7d-4c9e-8a21-6d4f0b9e7c35",
  "full_name": "Maria Schmidt",
  "date_of_birth": "1990-04-02",
  "masked_email": "m***@example.com"
}
```

Test verisi oluşturan sandbox soyadları hariç tutulur.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "first_name": "Maria",
    "last_name": "Schmidt",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "profile_group": "acme-clinic-berlin",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "marketing_emails_enabled": false
  }'
```

```json 201 theme={null}
{
  "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
}
```

```json 400 theme={null}
{
  "error": "date_of_birth: Birthdate cannot be in the future."
}
```

```json 404 theme={null}
{
  "error": "Profile group 'acme-clinic-berlin' not found"
}
```


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