# Sağlık API'si: Nedir ve Nasıl Çalışır?

> Bir sağlık API'sinin ne olduğu, bir çağrının nasıl çalıştığı, nelere dikkat edilmesi gerektiği ve hasta rızası, köken bilgisi ve AB barındırma özelliklerine sahip ücretsiz bir FHIR R4 sağlık API'si — örnekler ve SSS ile birlikte.

Source: https://developers.anpheros.com/tr/guides/healthcare-api

**Sağlık API'si, yazılımın sağlık verilerini (hasta kayıtları, gözlemler, teşhisler, ilaçlar, belgeler) okuyup yazdığı ve bu verilere erişimin yetkilendirildiği programatik bir arayüzdür.** Anpheros Platform API'si, hasta kontrollü bir HL7 FHIR R4 kaydı üzerinden çalışan bir sağlık API'sidir: uygulamalar bunu tıbbi verileri depolamak ve almak, hastanın rızasını almak ve değişikliklerden haberdar olmak için kullanır.

<!-- visual: hapi-hero -->

## Bir Sağlık API Çağrısı Nasıl Çalışır

Hangi satıcı olursa olsun, bir sağlık API çağrısı aynı kontrol noktalarından geçer: kimin çağırdığı, hangi hastanın ve hangi verilere erişebileceği, verilerin nerede depolandığı, kimin yazdığı ve kimin değiştiğini bilmesi gerektiği.

<!-- visual: hapi-request -->

## Sağlık API'lerinin Türleri

| Tür | Ne Değiş tokuş eder | Tipik Kullanım |
|---|---|---|
| FHIR REST API'leri | HTTP üzerinden FHIR kaynakları (`GET /Observation?patient=…`) | Klinik veri değişimi için modern standart |
| SMART on FHIR / OAuth | FHIR API'leri için yetkilendirme | Kullanıcının izniyle üçüncü taraf uygulamaların bir kayda erişmesine izin verme |
| HL7 v2 mesajlaşma | boru ile ayrılmış mesajlar (sonuçlar için `ORU^R01`, kabul işlemleri için `ADT`) | Laboratuvar ve hastane sistemleri, genellikle HTTP yerine arayüzler üzerinden |
| Belge değişimi | Klinik belgeler (PDF, CDA, FHIR belge paketleri) | Özetler, taburcu mektupları, sevkler |
| Özel REST API'leri | Satıcıya özgü JSON | Tek bir ürünün kendi mobil uygulaması veya entegrasyonları |

Anpheros, ilk ikisini temel olarak birleştirir, HL7 v2 laboratuvar sonuçlarını girdi olarak kabul eder, belgeleri orijinalleriyle birlikte depolar ve FHIR belge paketleri (Uluslararası Hasta Özeti) üretir. Ayrıca, FHIR ile doğrudan çalışmak istemeyen geliştiriciler için aynı veri üzerinde daha basit bir REST API sunar.

## Sağlık API'sinde Aranacaklar

<!-- visual:hapi-checklist:replace -->

- **Standart bir veri modeli**: Verilerin özel eşleme yapılmadan sistemler arasında hareket edebilmesi için.
- **Hastanın kontrolünde olan yetkilendirme**: Sadece uygulamanın kontrolünde olan kimlik bilgileri değil.
- **Köken (Provenance)**: Her bir değerin kim tarafından, kim adına, hangi sistemden yazıldığı.
- **Geçmiş (History)**: Sessiz üzerine yazmalar yerine sürümler.
- **Denetlenebilirlik (Auditability)**: Sadece yazmaların değil, okumaların da.
- **Güvenli yeniden denemeler** (idempotency) ve **öngörülebilir hatalar**: Sağlık verileri kopyalanmamalı veya kaybolmamalıdır.
- **İzolasyon**: Aynı altyapıyı paylaşan uygulamalar arasında.
- **Veri ikametgahı**: Hastaların bulunduğu yerle eşleşen.

Bu sayfanın geri kalanı, bunların her birinin Anpheros API'sinde nasıl göründüğünü göstermektedir.

## Anpheros API'ye Genel Bakış

| Yüzey | Temel yol | Amaç |
|---|---|---|
| FHIR R4 | `/fhir/R4` | 26 kaynak türü; okuma, arama, oluşturma, güncelleme, silme, geçmiş, işlemler, `$everything`, `$summary`, `$validate` |
| REST v1 | `/v1` | hastalar, gözlemler, durumlar, ilaçlar, belgeler, zaman çizelgesi, kökenbilim, AI bağlamı, laboratuvar içe aktarma, terminoloji, web kancaları |
| OAuth 2.1 | `/oauth` | onay sayfası, belirteçler (PKCE), geri alma, OpenID Connect anahtarları |
| Hasta tarafı | `/me` | bir kişinin kendi kayıtları, kimin erişimi olduğu, erişim günlüğü, geri alma |
| Keşif | `/fhir/R4/metadata`, `/fhir/R4/.well-known/smart-configuration`, `/openapi.json` | API'nin makine tarafından okunabilir açıklamaları |

Temel URL: `https://platform.anpheros.com`. Sandbox ve üretim bunu paylaşır; anahtar veri düzlemini belirler.

### Kimlik Doğrulama

- Sunucularınız için **API anahtarları** (`sk_test_…`, `sk_live_…`); projenizin oluşturduğu hastaları görürler.
- Bir onay kapsamında bir hasta adına hareket eden bir uygulama için **OAuth erişim belirteçleri** (`at_…`).

```bash
curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"
```

### Güvenli Yazma

`POST` istekleri bir `Idempotency-Key` kabul eder: aynı anahtarla yeniden denenmiş bir istek orijinal yanıtı döndürür ve hiçbir şey oluşturmaz. Her yazma işlemi bir `Provenance` alır; yazar türü gövdede (`author_type`) veya `X-Anpheros-Author-Type`, `X-Anpheros-Source-System`, `X-Anpheros-Origin-Id` ve `X-Anpheros-On-Behalf-Of` gibi üstbilgilerde gönderilir.

```bash
curl -X POST https://platform.anpheros.com/v1/patients/$PID/observations \
     -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" \
     -d '{"code": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'
```

### Hatalar ve Sınırlar

FHIR uç noktaları `OperationOutcome` ile yanıt verir; diğerleri `{"error": {"type", "message", "field"}}` ile. Her yanıt `Anpheros-Request-Id` taşır. Varsayılan sınır, anahtar başına ve IP başına dakikada 600 istektir. [Hatalar](https://developers.anpheros.com/tr/guides/errors) · [Sınırlar](https://developers.anpheros.com/tr/guides/limits)

### Olaylar

`resource.created`, `resource.updated`, `resource.deleted`, `consent.granted`, `consent.revoked`, `document.finalized` ve `ping` için imzalı web kancaları. [Web Kancaları](https://developers.anpheros.com/tr/guides/webhooks)

## FHIR ve REST v1 Arasında Seçim Yapma

FHIR ile zaten çalışıyorsanız, `/v1`'in kapsamadığı kaynak türlerine (örneğin `Immunization`, `Procedure` veya `CarePlan`) ihtiyacınız varsa veya diğer FHIR sistemleriyle veri alışverişi yapıyorsanız **FHIR**'ı kullanın. Yaygın durumlar için düz JSON isteyen uygulama kodu için **REST v1**'i kullanın. Her ikisi de aynı kaynakları aynı kimliklerle okur ve yazar, bu nedenle bir proje bunları karıştırabilir. [Medical data API](https://developers.anpheros.com/tr/guides/medical-data-api), veri işlemlerini ayrıntılı olarak açıklar.

## Sıkça Sorulan Sorular

### Sağlık API'si nedir?
Yazılımın hasta kayıtları, gözlemler, teşhisler, ilaçlar ve belgeler gibi sağlık verilerini okuyup yazdığı ve bu verilere erişimin yetkilendirildiği programatik bir arayüzdür. Modern sağlık API'leri veri için HL7 FHIR R4'ü ve yetkilendirme için SMART on FHIR ile OAuth 2.0 veya 2.1'i kullanır.

### Sağlık API'si ile FHIR API'si arasındaki fark nedir?
FHIR, bir sağlık API'sinin izleyebileceği bir standarttır. Bir FHIR API'si REST üzerinden FHIR kaynakları alışverişi yapar; bir sağlık API'si HL7 v2 mesajlarını, belgeleri veya özel JSON'ları da kabul edebilir. Anpheros, aynı veri üzerinde bir FHIR R4 API'si ve daha basit bir REST API'si sunar.

### Geliştiriciler için ücretsiz bir sağlık API'si var mı?
Evet. Anpheros sandbox ücretsiz ve self-servistir: Google ile oturum açın, bir API anahtarı alın ve FHIR R4 veya REST üzerinden 30 sentetik hasta ile çalışın. Üretim aylık 99 €'dan başlar, ilk ay ücretsizdir.

### Hastalar sağlık API'sine nasıl izin verir?
PKCE ile OAuth 2.1 aracılığıyla: uygulama kişiyi SMART on FHIR kapsamlarıyla bir izin sayfasına gönderir; kişi neyi ne kadar süreyle paylaşacağını seçer, bir erişim günlüğü görebilir ve istediği zaman erişimi iptal edebilir.

### Veriler nerede saklanıyor?
Avrupa Birliği'nde: hizmet ve veritabanları Google Cloud `europe-west4` (Hollanda) üzerinde çalışır.

### Hangi sağlık API'sini seçmeliyim?
Veri standardını, erişimi kimin yetkilendirdiğini, menşe ve denetimi, veri ikametini, yeniden denemelerin ve hataların nasıl davrandığını ve gerçekçi verilerle ücretsiz olarak test edip edemeyeceğinizi karşılaştırın. [Sağlık API platformu: neleri içerir ve nasıl seçilir](https://developers.anpheros.com/tr/guides/healthcare-api-platform) bunları herhangi bir satıcıya sormanız gereken sorular haline getirir.

<!-- visual:cta-hapi -->

## İlgili Konular

- [EHR API ve tıbbi kayıtlar API'si](https://developers.anpheros.com/tr/guides/ehr-api)
- [Sağlık API platformu: Neler içerir ve nasıl seçilir](https://developers.anpheros.com/tr/guides/healthcare-api-platform)
- [TypeScript ile sağlık API'si nasıl oluşturulur](https://developers.anpheros.com/tr/guides/healthcare-api-typescript): Express ile adım adım öğretici
- [FHIR R4 kullanarak tıbbi kayıtlar nasıl saklanır](https://developers.anpheros.com/tr/guides/store-medical-records-fhir): curl ile adım adım öğretici
- [Hasta onayı ile sağlık API'si](https://developers.anpheros.com/tr/guides/healthcare-api-patient-consent)
- [SMART on FHIR backend](https://developers.anpheros.com/tr/guides/smart-on-fhir-backend)
- [Tıbbi veri API'si](https://developers.anpheros.com/tr/guides/medical-data-api)
- [FHIR platformu](https://developers.anpheros.com/tr/guides/fhir)
- [Sağlık verisi birlikte çalışabilirliği](https://developers.anpheros.com/tr/guides/interoperability)
- [Sağlık entegrasyonları](https://developers.anpheros.com/tr/guides/healthcare-integrations)
- [API referansı (OpenAPI)](https://developers.anpheros.com/docs) · [Kimlik Doğrulama ve OAuth](https://developers.anpheros.com/tr/guides/authentication)