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

# Profiller

> Aniva Partner API'sinde hasta profilleri nasıl çalışır: Adına kan tahlili ve evde test kiti aldığın kişileri oluştur, güncelle ve bağla.

Profil, Aniva sisteminde bir hastayı veya kullanıcıyı temsil eden kayıttır. Her randevu, laboratuvar siparişi ve sonuç bir profille ilişkilendirilir.

## Profil grupları

Bir profil oluşturduğunda onu `profile_group` parametresini kullanarak bir **profil grubuna** atarsın. Bir profil grubu, iş ortağı hesabının altındaki profilleri düzenler ve bunları belirli bir program veya entegrasyon kapsamına alır.

`profile_group` alanı, grubun değiştirilemez UUID'sini veya insan tarafından okunabilir slug değerini kabul eder. UUID kalıcı referanstır — asla değişmez ve slug yeniden adlandırmalarında da geçerliliğini korur. Slug, okunabilir URL'ler ve iş ortağı entegrasyonları için tasarlanmıştır.

Oluşturma sırasında bir `profile_group` değeri (UUID veya slug) gereklidir. Eski `profile_group_slug` alanı, kullanımdan kaldırılmış bir takma ad olarak kabul edilmeye devam eder.

## Alanlar

**id** `string` *required*

Aniva tarafından otomatik oluşturulan UUID. Diğer API çağrılarında profile başvurmak için bunu
kullan.

**handle** `string`

Profil için isteğe bağlı kullanıcı adı veya tanıtıcı. Null olabilir.

**first\_name** `string`

Hastanın adı. Yalnızca Latin karakterleri, 1–100 karakter. Oluşturma sırasında gereklidir.

**last\_name** `string`

Hastanın soyadı. Yalnızca Latin karakterleri, 1–100 karakter. Oluşturma sırasında gereklidir —
laboratuvarlar soyadı olmayan bir hasta için verilen siparişleri reddeder. Zorunlu hale gelmeden
önce oluşturulan profillerde null olabilir.

**email** `string`

Hastanın e-posta adresi. Oluşturma sırasında bir adres sağlamazsan Aniva otomatik olarak bir yer
tutucu e-posta oluşturur.

**phone** `string`

[E.164 biçiminde](https://www.itu.int/rec/T-REC-E.164/en) telefon numarası (ör. `+14155552671`).
Null olabilir.

**sex** `integer`

[ISO/IEC 5218](https://www.iso.org/standard/36266.html) standardına göre biyolojik cinsiyet: `1`
\= erkek, `2` = kadın. Profil grubun hastanın bunu girmesine izin vermiyorsa oluşturma sırasında
gereklidir (aşağıya bak). Laboratuvar buna referans aralıkları için ihtiyaç duyar, bu nedenle `0`
(bilinmiyor) ile yapılan oluşturma veya güncelleme `400` döndürür. 30 Eylül 2026'dan önce
oluşturulan profiller hâlâ `0` döndürebilir.

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

`YYYY-MM-DD` biçiminde doğum tarihi. Profil grubun hastanın bunu girmesine izin vermiyorsa
oluşturma sırasında gereklidir (aşağıya bak). Geçmişte olmalı, 1900'den önce olmamalı ve 16 ile
100 arasında bir yaşa karşılık gelmelidir; gerçekçi olmayan değerler `400` ile reddedilir. Doğum
tarihi siparişle birlikte laboratuvara gönderilir ve sipariş verildikten sonra değiştirilemez.

**height** `number`

Santimetre cinsinden boy. Null olabilir.

**weight** `number`

Kilogram cinsinden kilo. Null olabilir.

**language** `string`

Hastalara yönelik iletişimlerde tercih edilen dil. Kabul edilen değerler: `en`, `de`, `fi`.

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

Profilin randevu onayları ve sonuç hazır bildirimleri gibi işlemsel e-postaları alıp almadığı.
Pazarlama onayından ayrıdır. Hiç ayarlanmamışsa null olur.

**created\_at** `string` *required*

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

**updated\_at** `string`

En son güncellemenin ISO 8601 zaman damgası. Profil hiç güncellenmediyse null olur.

> [!NOTE]
>
> Profil oluştururken `first_name`, `last_name`, `sex`, `date_of_birth` ve `profile_group` alanları
> gereklidir. Diğer tüm alanlar isteğe bağlıdır. Eski `profile_group_slug` alanı, `profile_group`
> için kullanımdan kaldırılmış bir takma ad olarak kabul edilmeye devam eder.

### Hastanın doğum tarihi ve cinsiyeti girmesine izin ver

Profil grubun için bir ayarı açabiliriz. Böylece `date_of_birth` ve `sex` olmadan profil
oluşturabilirsin. Açmamızı bizden iste. Bu ayar olmadan, iki alandan herhangi birini içermeyen bir
oluşturma isteği `400` döndürür.

Hasta her ikisini de kit koduyla birlikte kit etkinleştirme sayfasında (`anivahealth.com/activate`)
girer. Sayfa doğum tarihini iki kez sorar, çünkü laboratuvar bunu daha sonra değiştiremez. Bundan
sonra kit yalnızca o doğum tarihiyle açılır. Hasta her ikisini de girene kadar laboratuvar
siparişini bekletiriz. Bu ayarı yalnızca evde test kitleri için kullan.

## Yaşam döngüsü

Profiller basit bir yaşam döngüsü izler:

1. **Oluştur** — profili zorunlu demografik alanlar ve bir `profile_group` (UUID
   veya slug) ile kaydet.
2. **Güncelle** (isteğe bağlı) — `phone`, `height` veya `weight` gibi alanlar ekle ya da değiştir.
3. **İlişkilendir** — profilin `id` değerini `profile_id` olarak kullanarak profili randevulara bağla.

Bir `profile.*` [webhook'u](https://docs.anivahealth.com/tr/concepts/webhooks.md) bir profil oluşturulduğunda, değiştiğinde veya silindiğinde sana haber verir.

## Örnek profil

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "handle": "jdoe42",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane.doe@example.com",
  "phone": "+14155552671",
  "sex": 2,
  "date_of_birth": "1990-06-15",
  "height": 168.0,
  "weight": 65.0,
  "language": "en",
  "transactional_emails_enabled": true,
  "created_at": "2026-03-01T09:00:00Z",
  "updated_at": "2026-03-10T14:32:00Z"
}
```


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