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

# Giriş

> Eczanelerde ve muayenehanelerde kan tahlilleri, evde test kitleri ve laboratuvar sonuçları için bir REST API olan Aniva Partner API'sine genel bakış.

Aniva Partner API; sağlık iş ortaklarının hasta profillerini yönetmesini, test konumlarında kan alma randevuları planlamasını ve laboratuvar sipariş akışlarını tetiklemesini sağlayan bir REST API'dir. İş ortağı API anahtarını kullanarak API ile HTTPS üzerinden iletişim kurarsın.

## Neler yapabilirsin

* **Profil yönetimi** — Hasta demografik profilleri oluştur, getir ve güncelle.
* **Randevu planlama** — Aniva test konumlarında kan alma randevuları al.
* **Panel yönetimi** — Mevcut bir randevuya laboratuvar test panelleri ekle veya randevudan çıkar.
* **Tekil biyobelirteçler** — Bir panel seçmeden randevuya tekil biyobelirteçler ekle veya randevudan çıkar.
* **Evde test kiti siparişleri** — Hastaya eve gönderilen bir test kiti yolla, kargolarını takip et ve örneğin ne zaman alındığını bildir.
* **Panel kataloğu** — Panel ID'lerini ve içerdikleri biyobelirteçleri görmek için `GET /api/v1/panels` ile mevcut panellere göz at.
* **Biyobelirteç kataloğu** — ID'leri bulmak için bir konumda veya evde test kitinde sipariş edebileceğin biyobelirteçlere `GET /api/v1/biomarkers` ile göz at.
* **Kan alma onayı** — Laboratuvar sipariş akışını tetiklemek için kan alma işleminden sonra laboratuvar kodunu (veya kodlarını) gönder.
* **Laboratuvar sonuçları** — Klinik ve genetik sonuçları getir ve laboratuvar raporu PDF'lerini indir.
* **Konum keşfi** — Hastalara sunmak için mevcut test konumlarını listele.
* **Gönderi lojistiği** — Kurye gönderi siparişleri oluştur, takip et, düzenle ve iptal et.
* **Webhook'lar** — Bir randevu, evde test kiti siparişi, sonuçları, bir konum, bir profil veya bir gönderi değiştiğinde HTTPS çağrısı al. [Webhook'lar](https://docs.anivahealth.com/tr/concepts/webhooks.md) sayfasına bak.

## Dokümanları keşfet

> [card] [Kimlik doğrulama](https://docs.anivahealth.com/tr/authentication.md)
>
> İsteklerin kimliğini iş ortağı API anahtarınla doğrula.

> [card] [Hızlı başlangıç](https://docs.anivahealth.com/tr/quickstart.md)
>
> Adım adım örneklerle dakikalar içinde ilk API çağrını yap.

> [card] [Profiller](https://docs.anivahealth.com/tr/concepts/profiles.md)
>
> Hasta profillerinin nasıl çalıştığını ve hangi verileri tuttuğunu öğren.

> [card] [Randevular](https://docs.anivahealth.com/tr/concepts/appointments.md)
>
> Planlamadan onaya kadar randevu yaşam döngüsünü anla.

> [card] [Evde test kiti siparişleri](https://docs.anivahealth.com/tr/concepts/home-kit-orders.md)
>
> Hastanın evine bir test kiti gönder ve örnek laboratuvara ulaşana kadar takip et.

## API sürümleme

Güncel API sürümü **v1**. Tüm uç noktalar `/api/v1/` ön ekiyle başlar. Temel URL `https://anivahealth.com` adresidir.

```text theme={null}
https://anivahealth.com/api/v1/
```

Geriye dönük uyumsuz değişiklikler yeni bir sürüm ön eki altında sunulacak. v1 API, herhangi bir kullanımdan kaldırma durumu önceden bildirilerek kullanılabilir kalmaya devam edecek.

## Tarihler ve saat dilimleri

Aktarılan tüm zaman noktaları **UTC ISO 8601** (`Z` son eki) biçimindedir. Yalnızca takvim alanları **duvar saati
bileşenleri** (`YYYY-MM-DD`, `HH:MM`) kullanır.

| Kategori | Format | Kullanım alanı |
| - | - | - |
| **Zaman noktası** | UTC olarak ISO 8601 (`Z` son eki, ör. `2026-04-15T08:30:00Z`) | Çıktıdaki her tarih-saat değeri — randevu `scheduled_at`, uygunluk `slots[]`, gönderi `pickup.from` / `pickup.till`, `created_at`, `updated_at`, `added_at`. İstemci tarafında istediğin yerel saat diliminde göster. |
| **Sağlayıcı olayı** | Üst sağlayıcının saat farkıyla ISO 8601 (olduğu gibi aktarılır) | Yalnızca gönderi `status_updates[].time` — saat farkı kuryenin bildirdiği değeri yansıtır. |
| **Duvar saati** | Tarihler için `YYYY-MM-DD`, saatler için `HH:MM` — saat farkı yok | Yalnızca takvim veya günün saati değerleri — `date_of_birth`, sonuçlar `tested_at`, uygunluk `start_date` / `end_date`, gönderi `pickup_date` / `pickup_time_from` / `pickup_time_till`, konum `open_hours`. |

Özel notlar:

* **Tarih-saat alan girdiler** (ör. `POST` / `PATCH /api/v1/appointments` üzerindeki `scheduled_at`)
  **bir saat dilimi belirteci içermelidir** — ya `Z` ya da `+02:00` gibi açık bir saat farkı. Saat
  dilimi olmayan tarih-saat değerleri `400` ile reddedilir. Her iki biçim de aynı zaman noktasını
  ifade eder; yanıt `scheduled_at` alanını her zaman UTC `Z` olarak döndürür. Zaman noktasını
  gösterirken yerel duvar saatine biçimlendirmek için konumun `timezone` alanını (veya başka bir
  IANA tanımlayıcısını) kullan.
* **Duvar saati girdileri** hedefledikleri kaynağın saat diliminde yorumlanır: uygunluk tarihleri
  `timezone` sorgu parametresini kullanır (varsayılan olarak konumun saat dilimi); gönderi
  `pickup_date` / `pickup_time_*` alanları çıkış konumunun saat diliminde yorumlanır.
* **Yalnızca tarih içeren yanıt alanları** (ör. `tested_at`, uygunluk `availability[].date`) saat
  dilimi olmayan takvim tarihleridir.

## Erişim alma

API anahtarları Aniva tarafından her iş ortağı için ayrı olarak verilir.

> [!NOTE]
>
> İş ortağı API anahtarını almak için Aniva ile iletişime geç.


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