# Bir sağlık uygulaması oluşturun

> Eğitim: Anpheros'u bir sağlık uygulamasının tıbbi veri arka ucu olarak kullanın — hastalar, ölçümler, durumlar, ilaçlar, belgeler, laboratuvarlar, onay, webhook'lar ve SDK'lar.

Source: https://developers.anpheros.com/tr/guides/build-a-healthcare-app

Bu eğitim, bir sağlık veya tıbbi uygulamanın Anpheros Platform'u tıbbi veri arka ucu olarak nasıl kullanabileceğini gösterir: hasta kayıtlarının nerede saklandığı, nasıl okunup yazıldığı, diğer sistemlerin nasıl bağlandığı ve hastanın kontrolü nasıl elinde tuttuğu. Aşağıdaki her çağrı, genel API'nin bir parçasıdır ([referans](https://developers.anpheros.com/docs)).

## İnşa Ettiğiniz Şey

Tipik bir hasta odaklı uygulama — kronik durum takipçisi, aile sağlığı uygulaması, uzaktan izleme yardımcısı — şunları yapmalıdır:

1. hasta başına bir kayıt tutmak: ölçümler, durumlar, ilaçlar, belgeler;
2. bu kaydı listeler ve bir zaman çizelgesi olarak geri göstermek;
3. diğer kaynaklardan (cihazlar, laboratuvarlar, klinikler) veri kabul etmek;
4. hastanın rızasıyla kaydın bazı bölümlerini paylaşmak;
5. bir şey değiştiğinde tepki vermek.

Anpheros ile uygulamanız kendi kullanıcılarını, ekranlarını ve iş mantığını tutar ve tıbbi kaydı platforma devreder:

```
Mobile / web app ──► your backend ──► Anpheros Platform API ──► FHIR R4 record of each patient
                         ▲                                              │
                         └──────────── signed webhooks ◄────────────────┘
```

Arka ucunuz API anahtarını tutar; uygulama arka ucunuzla konuşur. (Zaten bir Anpheros kaydı olan bir hasta adına hareket eden uygulamalar bunun yerine OAuth kullanır — bkz. adım 7.)

## 1. Bir sandbox anahtarı alın

Sandbox kendi kendine hizmet verir: kontrol panelinde (`https://platform.anpheros.com/dashboard/`) Google ile oturum açın ve *Bir sandbox anahtarı alın* düğmesine basın. Sandbox anahtarları `sk_test_` ile başlar ve yalnızca sandbox veritabanına erişebilir; burada projenizin zaten 30 sentetik hastanın kendi kopyası bulunmaktadır.

```bash
export BASE=https://platform.anpheros.com
export KEY=sk_test_…
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"
```

## 2. Hasta oluşturma

Uygulamanızın her kullanıcısı, projenize ait bir hasta kaydı alır.

```bash
curl -X POST $BASE/v1/patients -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -H "Idempotency-Key: $(uuidgen)" \
     -d '{"given": "Elena", "family": "Ionescu", "birth_date": "1985-09-03", "gender": "female"}'
```

Yanıt, hastanın `id` (bu kişi için kendi tanımlayıcınız - diğer projeler farklı bir tane görür) ve onun `fhir` referansını içerir.

## 3. Ölçümleri, Tanıları ve İlaçları Yazma

Verinin kimden geldiğini `author_type`: `patient`, `practitioner`, `device`, `import` veya `ai` ile belirtin. Eğer bunu belirtmezseniz, platform varsayılan olarak `import` kaydeder, asla `patient` kaydetmez.

```bash
# a blood-pressure reading from a connected device (LOINC panel with two components)
curl -X POST $BASE/v1/patients/$PID/observations -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -H "Idempotency-Key: $(uuidgen)" -d '{
  "code": "85354-9", "display": "Blood pressure panel", "category": "vital-signs",
  "effective_at": "2026-09-28T08:00:00Z", "author_type": "device",
  "components": [
    {"code": "8480-6", "display": "Systolic", "value": 128, "unit": "mm[Hg]"},
    {"code": "8462-4", "display": "Diastolic", "value": 82, "unit": "mm[Hg]"}
  ]}'

# a diagnosis (ICD-10 by default)
curl -X POST $BASE/v1/patients/$PID/conditions -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"code": "I10", "display": "Essential hypertension", "onset": "2024-03-01", "author_type": "practitioner"}'

# a medication (ATC by default)
curl -X POST $BASE/v1/patients/$PID/medications -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"display": "Amlodipine 5 mg", "code": "C08CA01", "dosage": "1 tablet in the morning", "start": "2024-03-01", "author_type": "patient"}'
```

Gözlem kategorileri: `vital-signs`, `laboratory`, `symptom`, `activity`, `survey`, `exam`, `imaging`, `social-history`. Her yazma işlemi bir FHIR kaynağı olarak saklanır ve otomatik olarak bir `Provenance` girişi alır.

## 4. Belgeleri Saklama

```bash
# create the document, then upload the bytes
curl -X POST $BASE/v1/patients/$PID/documents -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"title": "Blood tests 2026-09-14", "kind": "lab_report", "content_type": "application/pdf", "date": "2026-09-14"}'
curl -X PUT $BASE/v1/documents/$DOC/content -H "Authorization: Bearer $KEY" -H 'content-type: application/pdf' --data-binary @report.pdf
```

Yükleme sonrasında orijinali değiştirilemez; ondan çıkardığınız değerler `derived_from` ile ona geri dönebilir.

## 5. Kaydı Geri Oku

```bash
curl "$BASE/v1/patients/$PID/observations?category=vital-signs&limit=20" -H "Authorization: Bearer $KEY"
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"   # everything, chronologically
```

Tam FHIR modeline ihtiyaç duyduğunuzda, aynı veriler `/fhir/R4` adresinde aynı kimliklerle mevcuttur ([FHIR R4 API](https://developers.anpheros.com/tr/guides/fhir)).

## 6. Laboratuvarları ve Cihazları Bağlama

- **Laboratuvar Raporları:** CSV, HL7 v2 ORU^R01 veya JSON ile `POST /v1/patients/{id}/labs/import`, tüm raporu LOINC kodlu laboratuvar Gözlemlerine (Observations) dönüştürür ([Laboratuvar Bağlayıcısı](https://developers.anpheros.com/tr/guides/lab-connector)).
- **Cihazlar ve Giyilebilir Teknolojiler:** `author_type: device` ve ölçümün LOINC kodu ile Gözlemler (Observations) yazın (kalp atış hızı, SpO₂, adım sayısı, uyku süresi ve diğerleri [FHIR Kod Sistemlerinde](https://developers.anpheros.com/tr/guides/fhir-code-systems) listelenmiştir).

## 7. Hastanın Zaten Sahip Olduğu Bir Kayda Erişme (OAuth)

Kişinin Anpheros'ta zaten bir kaydı varsa (örneğin Anpheros Daily aracılığıyla), uygulamanız yeni bir hasta oluşturmak yerine erişim talep edebilir: bir uygulama kaydedin, ihtiyacınız olan kapsamlarla kişiyi onay sayfasına gönderin, kodu belirteçlerle değiştirin ve erişim belirteciyle API'yi çağırın. Hasta süreyi seçer ve istediği zaman erişimi iptal edebilir. Ayrıntılar: [Kimlik Doğrulama ve OAuth](https://developers.anpheros.com/tr/guides/authentication).

## 8. Webhook'lar ile Değişikliklere Tepki Verin

```bash
curl -X POST $BASE/v1/webhooks -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"url": "https://your.app/anpheros/hook", "events": ["resource.created", "consent.revoked"]}'
```

Her teslimatın `Anpheros-Signature` başlığını doğrulayın ([Webhook'lar](https://developers.anpheros.com/tr/guides/webhooks)).

## 9. Bir SDK Kullanın

Aynı akış TypeScript'te:

```ts
import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });
const { data: patients } = await anpheros.patients.list();
const vitals = await anpheros.observations.list(patients[0].id, { category: 'vital-signs', limit: 20 });
```

Aynı yapıya sahip bir Dart / Flutter istemcisi `anpheros_sdk` ([SDK'lar](https://developers.anpheros.com/tr/guides/sdks)) olarak mevcuttur.

## Üretime Geçmeden Önce

- Üretim anahtarları (`sk_live_`), imzalanmış bir veri işleme sözleşmesi olan doğrulanmış kuruluşlara verilir.
- [Güvenlik, gizlilik ve veri ikametgahı](https://developers.anpheros.com/tr/guides/security) sayfasını ve [limitleri](https://developers.anpheros.com/tr/guides/limits) okuyun.
- Hataları türlerine göre ele alın ve destek ile iletişime geçerken `Anpheros-Request-Id` başlığına atıfta bulunun ([Hatalar](https://developers.anpheros.com/tr/guides/errors)).

## İlgili Kaynaklar

- [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 eğitim
- [Flutter ile Sağlık Uygulaması Nasıl Oluşturulur](https://developers.anpheros.com/tr/guides/healthcare-app-flutter): Dart SDK ile adım adım eğitim
- [FHIR Backend ile Yapay Zeka Sağlık Uygulaması Nasıl Oluşturulur](https://developers.anpheros.com/tr/guides/build-ai-healthcare-app): TypeScript ile adım adım eğitim
- [Anpheros ile Geliştirme](https://developers.anpheros.com/tr/guides/build-with-anpheros)
- [Tıbbi Uygulama Backend'i ve Veritabanı](https://developers.anpheros.com/tr/guides/medical-app-backend)
- [Tıbbi Veri API'si](https://developers.anpheros.com/tr/guides/medical-data-api)
- [Sağlık Yazılım Geliştirme](https://developers.anpheros.com/tr/guides/healthcare-software)
- [FHIR ile Kişisel Sağlık Kaydı (PHR) Uygulaması Nasıl Oluşturulur](https://developers.anpheros.com/tr/guides/personal-health-record-app)