Sağlık verisi API'si: Nelere dikkat etmeli, hasta kaydı nasıl okunur ve yazılır (bir saatte)

"Sağlık API'si" çok farklı şeyleri kapsar: bir hastanenin HL7 v2 akışı, ulusal bir e-reçete hizmeti, bir giyilebilir cihaz satıcısının dışa aktarması, bir FHIR sunucusu. Bir sağlık uygulaması, bir klinik aracı veya bir yapay zeka asistanı geliştiriyorsanız, ihtiyacınız daha dar kapsamlıdır: hastanın kaydını standart bir formatta tutan, hastanın kimin okuyacağına karar vermesine izin veren ve size temiz bir API sağlayan bir arka uç. Bu kılavuz, nelere bakmanız gerektiğini belirtir ve gerçek çağrılarla Anpheros Platform'da ilk saatin nasıl göründüğünü gösterir.

Geliştiriciler için teknik sürüm: Sağlık API'si · Tıbbi veri API'si developers.anpheros.com adresinde, istekler, yanıtlar ve limitlerle birlikte. Bu sayfa sade dil sürümüdür.

Bir sağlık verisi API'sinin yapması gerekenler

Kullanılabilir bir sağlık verisi API'sini önünde HTTP olan bir veritabanından ayıran beş şey vardır.

• Standart bir format. HL7 FHIR R4, hastanelerin, ulusal sistemlerin ve AB'nin sağlık verileri alanının kullandığı formattır. FHIR'de saklanan bir kayıt, özel bir köprü olmadan diğer sistemler tarafından okunabilir. Tescilli bir JSON bunu yapamaz.
• Hasta onayı birinci sınıf bir nesne olarak. Kimin neyi, ne kadar süreyle okuyabileceği, geri alınabilir, hasta tarafından görülebilir. Kendi veritabanınızdaki bir onay kutusu değil.
• Köken (Provenance). Her değer kimin yazdığını belirtir: hasta, bir uygulayıcı, bir cihaz, bir içe aktarma, türetilmiş bir hesaplama. Bir laboratuvar sonucunu kendi bildirdiği bir tahminden ayırt edemeyen bir yapay zeka asistanı tehlikelidir.
• Gerçekçi verilerle bir sandbox. Gerçek hastalarla test yapamazsınız ve kendiniz altı aylık geçmişi olan 30 sentetik hasta icat etmek zorunda kalmamalısınız.
• Belirtebileceğiniz veri ikametgahı. Avrupalı kullanıcılar için bu, GDPR kapsamında, veri işleme sözleşmesiyle birlikte AB'deki sunucular anlamına gelir.

İki giriş yolu: REST ve FHIR, aynı veri

Anpheros Platform aynı kaydı iki kez sunar. Ürün kodu için basit bir REST API (/v1) ve sağlık sisteminin geri kalanıyla konuşması gereken her şey için katı FHIR R4 (/fhir/R4). Kimlikler her ikisinde de aynıdır; her v1 nesnesi fhir referansını taşır.

export BASE=https://platform.anpheros.com
export KEY=sk_test_…

# projenizin görebildiği hastalar
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# laboratuvar sonuçları, en yenisi önce
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# aktif ilaçlar
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# her şey tek bir zaman çizelgesinde
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# aynı veri, katı FHIR
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

Bu çağrıların arkasında 26 FHIR kaynak türü (Hasta, Gözlem, Durum, İlaç Beyanı, Alerji İntoleransı, Aşı, Belge Referansı, Karşılaşma, Onay, Köken ve daha fazlası) bulunur; ölçümler için LOINC, durumlar için ICD-10 ve ilaçlar için ATC ile kodlanmıştır.

Anahtar almak bir dakika sürer

Sandbox kendi kendine hizmettir ve ücretsizdir. platform.anpheros.com/dashboard adresindeki kontrol panosuna giriş yapın, Bir sandbox anahtarı al düğmesine basın ve bir kuruluş, bir sandbox projesi ve bir sk_test_… anahtarınız olur. Proje, 30 sentetik hastanın kendi kopyasıyla birlikte gelir: yetişkinler, çocuklar ve yaşlılar, AB genelinden, altı aylık durumlar, ilaçlar, alerjiler, laboratuvar sonuçları ve yaşamsal belirtilerle. Her şeyi değiştirin veya silin; bir sıfırlama onları geri getirir.

Üretim anahtarları (sk_live_…), imzalanmış bir veri işleme sözleşmesi olan doğrulanmış kuruluşlara gider. Sandbox ve üretim farklı veritabanlarıdır: bir sandbox anahtarı fiziksel olarak gerçek bir hastaya ulaşamaz.

Kutuda başka neler var

• OAuth 2.1 PKCE ile ve SMART on FHIR bağımsız başlatma, böylece bir uygulama bir kişiden kendi kaydına erişim isteyebilir.
• Kapsamlar, son kullanma ve geri alma ile onay ve hastanın okuyabileceği bir erişim günlüğü.
• resource.created, consent.granted, consent.revoked, document.finalized için İmzalı web kancaları (HMAC-SHA256, geri bildirimle yeniden denenir).
• Bir token bütçesi dahilinde bir hastanın köken etiketli bir özetini oluşturan bir yapay zeka bağlam API'si.
• CSV, HL7 v2 ORU^R01 veya JSON'dan laboratuvar raporu içe aktarma, LOINC'e eşlenmiş.
• Uluslararası Hasta Özeti ($summary) ve QR ile paylaşım için SMART Health Bağlantıları.
• Dart ve TypeScript için SDK'lar, /docs adresinde bir OpenAPI referansı ve /fhir/R4/metadata adresinde bir CapabilityStatement.

Yanıtlarla birlikte tam adım adım kılavuz developers.anpheros.com/guides/first-hour adresindedir.

Sık sorulan sorular

Bugün başlayabileceğim ücretsiz bir sağlık API'si var mı?

Evet. Anpheros sandbox ücretsiz ve kendi kendine hizmettir: giriş yapın, bir anahtar alın ve okuyup yazabileceğiniz 30 sentetik hastanız olur. Limitler proje başına günde 10.000 kaynak yazma, kendi 100 hastanız ve 250 MB belge şeklindedir.

REST mi yoksa FHIR mi, hangisini kullanmalıyım?

Kendi ürün kodunuz için /v1 kullanın: daha basittir ve düz JSON döndürür. Verilere başka bir sistemin erişmesi gerektiğinde, FHIR araması, _history, $everything veya $summary istediğinizde veya bir sertifika bunu gerektirdiğinde /fhir/R4 kullanın. Her ikisi de aynı kaydı görür.

Hasta onayı nasıl ele alınıyor?

Bir kişi, kapsamları ve bir süre (30, 90, 180 veya 365 gün) seçerek OAuth aracılığıyla bir uygulamaya kaydına erişim izni verir. Yetkilendirme herhangi bir zamanda geri alınabilir ve hasta bir erişim günlüğündeki her okumayı görür. Ayrıntılar onay modelinde bulunur.

Veriler nerede barındırılıyor?

Avrupa Birliği'nde (Cloud Run, europe-west4), her yazmada köken ve sürüm geçmişi ile birlikte. Üretim kullanımı imzalanmış bir veri işleme sözleşmesi gerektirir.

Üretim maliyeti nedir?

Üretim, 2.500 saklanan hasta için ayda 49 €'dan başlar, ilk ay ücretsizdir; daha büyük planlar ayda 199 € ve 799 €'dur. Sandbox ücretsiz kalır. Fiyatlandırmaya bakın.

Yapay zeka ajanlarıyla çalışır mı?

Evet. Köken etiketleri ve bir token bütçesi olan bir yapay zeka bağlam API'si ve platform.anpheros.com/mcp adresinde MCP uyumlu herhangi bir asistanın bağlanabileceği bir MCP sunucusu bulunur. Yapay zeka tıbbi asistanlarıyla EMR entegrasyonuna bakın.