# Sağlık Entegrasyonları

> Bugün desteklenen entegrasyon modelleri: tek çağrıda laboratuvar raporları, bir kuruluş adına yazan klinikler, cihazlar, izin verilen üçüncü taraf uygulamalar, webhook'lar ve SDK'lar — ve mevcut olmayanlar.

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

**Bir sağlık entegrasyonu, sağlık verisi üreten veya ihtiyaç duyan bir sistemi — bir laboratuvar, bir klinik, bir cihaz, başka bir uygulama — hastanın kaydına bağlar.** Anpheros ile her entegrasyon aynı API ve aynı kurallardan geçer: veriler HL7 FHIR R4 olarak yazılır, kaynağına atfedilir, hasta tarafından görülebilir ve hastanın rızası olmadan diğer taraflarla yalnızca paylaşılır. Bu sayfa, platformun bugün desteklediği entegrasyon modellerini açıklamaktadır.

[Anpheros entegrasyon dizinini keşfedin](https://anpheros.com/integrations) ve doğrulanmış durumu (mevcut, beta veya geliştirici kılavuzu), alışveriş yaptığı verileri ve FHIR kaynaklarını, yönünü, kimlik doğrulamasını ve belgelerini içeren her entegrasyonu görün.

## Laboratuvarlar: tüm raporlar tek çağrıda

Bir laboratuvar veya laboratuvar raporlarını tutan herhangi bir sistem, eksiksiz bir rapor gönderir ve platform her sonucu bir laboratuvar `Observation`'ye dönüştürür:

```bash
curl -X POST https://platform.anpheros.com/v1/patients/$PID/labs/import \
     -H "Authorization: Bearer $KEY" -H "Content-Type: text/csv" \
     -H "X-Anpheros-Source-System: labx" -H "Idempotency-Key: report-2026-0917-77" \
     --data-binary @report.csv
```

- Formatlar: **CSV** (Rumen veya İngilizce başlıklar, ondalık virgül kabul edilir), **HL7 v2 ORU^R01** ve **JSON**.
- İşaretleyiciler, rapor bir kod verdiğinde veya ad platformun terminolojisiyle eşleştiğinde **LOINC**'e eşlenir; diğerleri laboratuvarın kendi kodunu korur ve `unmapped` olarak listelenir.
- Her satır kararlı bir tanımlayıcı alır, bu nedenle **aynı raporun yeniden gönderilmesi zaten içe aktarılanları atlar**.
- İstek başına 500 satıra kadar; her sonuç, kaynak sistemi ve raporu adlandıran köken bilgisi taşır.

Ayrıntılar: [Lab bağlayıcısı](https://developers.anpheros.com/tr/guides/lab-connector).

## Klinikler: Bir Kuruluş Adına Yazma

Klinikler ve orada çalışan kişiler dizin kaynaklarıdır (`Organization`, `Practitioner`, `PractitionerRole`). Bir kliniğin sistemi, her isteğin arkasında kimin olduğunu belirtebilir:

- `X-Anpheros-Acting-As: PractitionerRole/<id>` — uygulamanız aracılığıyla çalışan uygulayıcı; erişim günlüğüne yazılır ve hastaya adıyla gösterilir;
- `X-Anpheros-On-Behalf-Of: Organization/<id>` — bir yazma işlemi için yapılan kuruluş;
- `X-Anpheros-Author-Ref: Practitioner/<id>` — `Provenance`'da kaydedilen yazar.

Hastanın rızasıyla klinik, diğer kuruluşların yazdıkları da dahil olmak üzere kaydın tamamını okur ve yalnızca kendisinin yazdıklarını değiştirir. Bir FHIR `transaction` paketi (`POST /fhir/R4`) ile birden fazla kaynak atomik olarak yazılabilir.

Dizinden tek bir işlem olarak yazılan bir ziyarete kadar işlenmiş bir örnek: [Klinik Sistemlerini Bir FHIR Backend ile Entegre Etme](https://developers.anpheros.com/tr/guides/integrate-clinic-systems-fhir).

Rıza → laboratuvar `Observation` akışı, bir klinik proje tarafından yazıldı → hastanın uygulamasında bildirim, bir test kliniği projesiyle uçtan uca gerçekleştirildi.

## Cihazlar ve Giyilebilir Teknolojiler

Cihazlardan gelen ölçümler, `author_type: "device"` ve bir LOINC kodu ile birlikte `Observation`'lerdir — kalp atış hızı, kan basıncı, SpO₂, ağırlık, glikoz, adımlar, uyku süresi ve diğerleri ([FHIR kod sistemleri](https://developers.anpheros.com/tr/guides/fhir-code-systems)). Anpheros Daily, Apple Health ve Health Connect'ten okuduğu günlük özetleri de aynı şekilde Observation olarak yazar. Anpheros, cihaz satıcılarının bulutlarına doğrudan bağlanmaz; uygulamanız veya arka ucunuz cihazı okur ve sonucu yazar. Apple Health, Health Connect ve Samsung Health'in nasıl okunacağı ve her metriğin LOINC'e nasıl eşleneceği: [FHIR'de Giyilebilir Veriler](https://developers.anpheros.com/tr/guides/wearable-data-fhir).

## Üçüncü Taraf Uygulamaları: Onaylanmış Erişim

Bir kişinin Anpheros'ta zaten tuttuğu verilere erişmek isteyen bir uygulama, bir kez kaydolur ve OAuth 2.1 ile PKCE (SMART on FHIR bağımsız başlatma) aracılığıyla onay ister:

1. `GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access` — barındırılan onay sayfası;
2. kişi kaydı ve süreyi (30, 90, 180 veya 365 gün) seçer;
3. `POST /oauth/token` kodu bir erişim jetonu (30 dakika) ve dönen bir yenileme jetonu (30 gün) ile değiştirir;
4. uygulama yalnızca o hastayı, yalnızca kapsamları dahilinde, kendi eşli kimliği altında görür.

[Kimlik Doğrulama ve OAuth](https://developers.anpheros.com/tr/guides/authentication)

## Olaylar: değişikliklere tepki verme

Sorgulama yerine bir webhook kaydedin. Teslimatlar HMAC-SHA256 ile imzalanır, 24 saate kadar geri çekilme ile yeniden denenir ve klinik içerik taşımayan kimlikler içerir. Başka bir proje erişiminiz olan bir kayda yazdığında, olay bunu belirtir (`data.external: true`, kaynak ile birlikte). [Webhook'lar](https://developers.anpheros.com/tr/guides/webhooks)

## SDK'ler

TypeScript (`@anpheros/sdk`) ve Dart / Flutter (`anpheros_sdk`) SDK'leri yukarıda belirtilen tüm özellikleri uygular — laboratuvar içe aktarma (`labs.importCsv`, `labs.importHl7`, `labs.importItems`), PKCE ile OAuth, webhook yönetimi ve imza doğrulama. [SDK'ler](https://developers.anpheros.com/tr/guides/sdks)

## Neler Mevcut Değil

- Belirli hastane EHR'lerine veya laboratuvar bilgi sistemlerine hazır bağlayıcılar; entegrasyonlar API'ye karşı oluşturulur.
- SMART EHR başlatma (bir EHR içinde başlatma); yalnızca bağımsız başlatma desteklenir.
- Doğrudan cihaz-satıcı entegrasyonları.

## İlgili

- [Anpheros FHIR backend ile klinik sistemleri entegre etme](https://developers.anpheros.com/tr/guides/integrate-clinic-systems-fhir): Klinik EMR'leri için adım adım eğitim
- [Tıbbi verileri normalleştirme](https://developers.anpheros.com/tr/guides/normalize-medical-data): Kodlar, birimler, tarihler, tekrarlar, doğrulama
- [Laboratuvar sonuçlarını bir FHIR kaydına aktarma](https://developers.anpheros.com/tr/guides/import-lab-results-fhir): CSV ve HL7 v2 ile adım adım eğitim
- [Sağlık verileri birlikte çalışabilirliği](https://developers.anpheros.com/tr/guides/interoperability)
- [Sağlık API'si](https://developers.anpheros.com/tr/guides/healthcare-api)
- [Mimari](https://developers.anpheros.com/tr/guides/architecture)
- [Kullanım senaryoları](https://developers.anpheros.com/tr/guides/use-cases)
