Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Sağlık Uygulaması Geliştirin

Öğretici: 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.

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

İ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:

hasta başına bir kayıt tutmak: ölçümler, durumlar, ilaçlar, belgeler;
bu kaydı listeler ve bir zaman çizelgesi olarak geri göstermek;
diğer kaynaklardan (cihazlar, laboratuvarlar, klinikler) veri kabul etmek;
hastanın rızasıyla kaydın bazı bölümlerini paylaşmak;
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.

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.

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.

# 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

# 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

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

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ı).
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 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.

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

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

9. Bir SDK Kullanın

Aynı akış TypeScript'te:

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) 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ı sayfasını ve limitleri 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).

İlgili Kaynaklar

TypeScript ile Sağlık API'si Nasıl Oluşturulur: Express ile adım adım eğitim
Flutter ile Sağlık Uygulaması Nasıl Oluşturulur: Dart SDK ile adım adım eğitim
FHIR Backend ile Yapay Zeka Sağlık Uygulaması Nasıl Oluşturulur: TypeScript ile adım adım eğitim
Anpheros ile Geliştirme
Tıbbi Uygulama Backend'i ve Veritabanı
Tıbbi Veri API'si
Sağlık Yazılım Geliştirme
FHIR ile Kişisel Sağlık Kaydı (PHR) Uygulaması Nasıl Oluşturulur

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card