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

# Hızlı başlangıç

> Dakikalar içinde ilk Aniva Partner API çağrını yap: Bir test noktası bul, bir profil oluştur ve kan alma randevusu al.

Bu rehber temel iş akışında sana yol gösterir: bir test konumu bulma, hasta profili oluşturma, randevu planlama ve kan almayı onaylama.

## Ön koşullar

Aniva tarafından verilmiş bir iş ortağı API anahtarına ihtiyacın var.

> [!NOTE]
>
> Henüz bir API anahtarın yoksa iş ortağı hesabın için bir anahtar almak üzere Aniva ile iletişime geç.

## Adımlar

**1. Mevcut konumları listele**

Planlayacağın randevu için bir `location_id` bulmak üzere test konumlarının listesini getir.

```bash theme={null}
curl https://anivahealth.com/api/v1/locations \
  -H "x-api-key: YOUR_API_KEY"
```

**Örnek yanıt**

```json theme={null}
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Unter den Linden",
    "house_number": "42",
    "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": "18:00" }],
      "tuesday": [{ "open": "08:00", "close": "18:00" }],
      "wednesday": [{ "open": "08:00", "close": "18:00" }],
      "thursday": [{ "open": "08:00", "close": "18:00" }],
      "friday": [{ "open": "08:00", "close": "16:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

Kullanmak istediğin konumun `id` değerini not et. 3. adımda buna ihtiyacın olacak.

**2. Profil oluştur**

Hastanın demografik verilerini göndererek bir hasta profili oluştur. `profile_group` profili iş ortağı hesabına bağlar — grubun değişmez UUID'sini veya okunabilir slug değerini kabul eder.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/profiles \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jordan",
    "last_name": "Rivera",
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "profile_group": "your-profile-group"
  }'
```

**İstek gövdesi alanları**

| Alan | Tür | Zorunlu | Açıklama |
| - | - | - | - |
| `first_name` | string | Evet | Hastanın adı |
| `last_name` | string | Evet | Hastanın soyadı |
| `sex` | integer | Evet\*\* | `1` = erkek, `2` = kadın (ISO/IEC 5218) |
| `date_of_birth` | string | Evet\*\* | `YYYY-MM-DD` formatında doğum tarihi. Geçmişte olmalı, 1900'den önce olmamalı ve 16–100 yaş aralığına karşılık gelmeli. |
| `profile_group` | string | Evet\* | İş ortağı profil grubunun UUID veya slug değeri. UUID sabit referanstır; slug da kabul edilir. |
| `profile_group_slug` | string | Hayır | **Kullanımdan kaldırıldı.** `profile_group` için slug takma adı. `profile_group` veya `profile_group_slug` alanlarından biri zorunludur. |
| `email` | string | Hayır | Hastanın e-posta adresi. Belirtilmezse otomatik oluşturulur. |
| `language` | string | Hayır | `en`, `de` veya `fi`. Varsayılan değer `en`. |
| `phone` | string | Hayır | E.164 formatında telefon numarası, örneğin `+4915123456789`. |
| `height` | number | Hayır | Santimetre cinsinden boy. |
| `weight` | number | Hayır | Kilogram cinsinden kilo. |
| `transactional_emails_enabled` | boolean | Hayır | Operasyonel e-postalar için profil grubu varsayılanını geçersiz kılar. |
| `marketing_emails_enabled` | boolean | Hayır | Pazarlama e-postaları için profil grubu varsayılanını geçersiz kılar. |

\*\* Profil grubun hastanın her ikisini de kit etkinleştirme sayfasında girmesine izin veriyorsa isteğe bağlıdır.
[Profiller](https://docs.anivahealth.com/tr/concepts/profiles.md#hastanin-dogum-tarihi-ve-cinsiyeti-girmesine-izin-ver) sayfasına bak.

**Örnek yanıt (201 Created)**

```json theme={null}
{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "handle": null,
  "first_name": "Jordan",
  "last_name": "Rivera",
  "email": "jordan.rivera@example.com",
  "phone": null,
  "sex": 1,
  "date_of_birth": "1990-04-15",
  "height": null,
  "weight": null,
  "language": "en",
  "transactional_emails_enabled": null,
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": null
}
```

Yanıttaki `id` değerini not et. Bir sonraki adımda bunu `profile_id` olarak kullanacaksın.

**3. Randevu planla**

Adım 2'deki `profile_id` ve adım 1'deki `location_id` ile bir randevu oluştur. `scheduled_at` değerini, [Müsaitliği getir](https://docs.anivahealth.com/tr/api/locations/get-availability.md) tarafından o konum için döndürülen bir zaman dilimi başlangıcına ayarla. API, zaman dilimi çizelgesinde olmayan bir saati reddeder.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "scheduled_at": "2026-04-10T09:00:00Z"
  }'
```

**Örnek yanıt (201 Created)**

```json theme={null}
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "scheduled_at": "2026-04-10T09:00:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T10:05:00Z",
  "updated_at": null,
  "profile": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "handle": null,
    "first_name": "Jordan",
    "last_name": "Rivera",
    "email": "jordan.rivera@example.com",
    "phone": null,
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "en",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T10:00:00Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Randevunun `id` değerini not et. Kan almayı onaylamak için bunu kullanacaksın.

**4. Kan almayı onayla**

Kan alma tamamlandıktan sonra kan almayı onaylamak ve laboratuvar sipariş akışını tetiklemek için laboratuvar kodunu (tüp barkodu) gönder. Tüplerin birden fazla kod taşıdığı bir kan alma işleminde bunun yerine `lab_codes` gönderilir — [Kan almayı onayla](https://docs.anivahealth.com/tr/api/appointments/confirm-blood-draw.md) sayfasına bak.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments/c3d4e5f6-a7b8-9012-cdef-123456789012/confirm \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lab_code": "7642001234"
  }'
```

**Örnek yanıt (200 OK)**

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

Onaylandıktan sonra laboratuvar sipariş akışı tetiklenir. Durumunun `"blood_drawn"` olarak değiştiğini doğrulamak için randevuyu getirebilirsin.

## Sonraki adımlar

* Hangi laboratuvar testlerinin yapılacağını belirtmek için [randevuya panel ekle](https://docs.anivahealth.com/tr/api/appointments/add-panels.md).
* Kan alma öncesinde yeniden planlamak veya konum değiştirmek için [randevuyu güncelle](https://docs.anivahealth.com/tr/api/appointments/update-appointment.md).
* Artık gerekmiyorsa [randevuyu iptal et](https://docs.anivahealth.com/tr/api/appointments/cancel-appointment.md).
* İşlendikten sonra klinik ve genetik sonuçları almak için [laboratuvar sonuçlarını getir](https://docs.anivahealth.com/tr/api/appointments/get-results.md).
* Laboratuvar raporu PDF'lerini almak için [belgeleri indir](https://docs.anivahealth.com/tr/api/documents/download-document.md).
* Hasta verilerini kontrol etmek veya görüntülemek için [profili getir](https://docs.anivahealth.com/tr/api/profiles/get-profile.md).
* Mevcut tüm uç noktalar ve parametreler için [API referansının](https://docs.anivahealth.com/tr/api/profiles/create-profile.md) tamamını incele.


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