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

> Adım adım rehber: Kan tahlili randevusu almadan önce Aniva Partner API'sinde hasta profilleri oluştur ve güncelle.

Bir hasta profili oluşturmak ve bunu profil grubuna atamak için bu kılavuzu kullan. Profiller, randevu planlamanın ve laboratuvar siparişlerini tetiklemenin başlangıç noktasıdır.

**1. Profil grubu referansını al**

Her profil, iş ortağı hesabına ait bir profil grubuna atanmalıdır. `profile_group` alanı grubun değişmez UUID'sini veya okunabilir slug değerini kabul eder — UUID asla değişmediği ve slug yeniden adlandırıldığında da geçerliliğini koruduğu için tercih edilir.

Profil grubu referansını bilmiyorsan almak için Aniva ile iletişime geç. Geçerli bir referans olmadan profil oluşturamazsın.

**2. Profili oluştur**

Hastanın demografik verileriyle `/api/v1/profiles` adresine bir `POST` isteği gönder.

> [!NOTE]
>
> `first_name` ve `last_name` alanlarının ikisi de zorunludur. Yalnızca Latin alfabesi harflerini (ü gibi aksanlı harfler dahil), boşlukları, tireleri ve kesme işaretlerini kabul ederler. Diğer alfabelerdeki adları göndermeden önce Latin alfabesine çevir.

> [!NOTE]
>
> `email` alanını boş bırakırsan Aniva profil için otomatik olarak yer tutucu bir e-posta adresi oluşturur. Bunu daha sonra bir `PATCH` isteğiyle güncelleyebilirsin.

> [!TIP]
>
> `language` alanı, Aniva'nın hastayla iletişim kurarken kullandığı dili belirler — örneğin randevu hatırlatmalarında ve sonuç bildirimlerinde. Bunu hastanın tercih ettiği dile göre ayarla. [Profil oluştur](https://docs.anivahealth.com/tr/api/profiles/create-profile.md) sayfası desteklenen değerleri listeler. Varsayılan olarak `en` kullanılır.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "first_name": "Emma",
    "last_name": "Müller",
    "sex": 2,
    "date_of_birth": "1990-04-15",
    "profile_group": "my-clinic-group",
    "email": "emma.muller@example.com",
    "language": "de"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/profiles', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    first_name: 'Emma',
    last_name: 'Müller',
    sex: 2,
    date_of_birth: '1990-04-15',
    profile_group: 'my-clinic-group',
    email: 'emma.muller@example.com',
    language: 'de',
  }),
});

const profile = await response.json();
```

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

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

`id` değerini kaydet — randevu planlamak ve profili güncellemek için buna ihtiyacın olacak.

**3. Profili güncelle (isteğe bağlı)**

Oluşturduktan sonra herhangi bir profil alanını güncellemek için `PATCH /api/v1/profiles/{id}` kullan. Tüm alanlar isteğe bağlıdır — yalnızca değiştirmek istediğin alanları ekle.

Aşağıdaki örnek bir telefon numarası ve boy ekler:

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56 \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "phone": "+4915123456789",
    "height": 168.5
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
  {
    method: 'PATCH',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      phone: '+4915123456789',
      height: 168.5,
    }),
  }
);

const updated = await response.json();
```

Başarılı bir istek, güncellenmiş tam profil nesnesiyle birlikte `200 OK` döndürür.

## Hata yönetimi

| Durum | Neden | Çözüm |
| - | - | - |
| `400 Bad Request` | Zorunlu bir alan eksik, bir değer aralığın dışında veya `date_of_birth` mantıksız (gelecekte, 1900'den önce veya 16–100 yaş aralığının dışında). | Belirli doğrulama mesajı için hata yanıtı gövdesini kontrol et ve isteği düzelt. |
| `403 Forbidden` | API anahtarının bu işleme erişimi yok veya belirtilen profil grubuna erişimin yok. | API anahtarı izinlerini ve profil grubu erişimini doğrulamak için Aniva ile iletişime geç. |
| `404 Not Found` | `profile_group` değeri hesabındaki hiçbir profil grubuyla eşleşmiyor (ne UUID ne de slug ile). | Referansın doğru olduğunu doğrula. UUID veya slug değerinden emin değilsen Aniva ile iletişime geç. |
| `409 Conflict` | Bu `email` için zaten bir profil mevcut (`error_name: "email_exists_error"`) veya bir `Idempotency-Key` farklı bir gövdeyle yeniden kullanılmış. | Bu e-posta için mevcut profili kullan veya yeni bir `Idempotency-Key` gönder. |


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