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

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

Q: Veriler nerede saklanıyor?

Avrupa Birliği'nde: hizmet ve veritabanları Google Cloud europe-west4 (Hollanda) üzerinde çalışır.

Sağlık API'si nedir, bir çağrı nasıl çalışır, nelere dikkat etmeli ve hasta onayı, veri kökeni ve AB barındırmalı ücretsiz bir FHIR R4 sağlık API'si — örnekler ve SSS ile.

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.

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.

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

What to look for in a healthcare API — and how Anpheros answers

Standard data modelHL7 FHIR R4 with LOINC, ICD-10, ATC, UCUM

Patient-controlled accessOAuth 2.1 consent with scopes, expiry and revocation

ProvenanceAuthor, organisation and source on every write

HistoryEvery version kept; conditional updates with If-Match

Audit of readsEach read and write logged, visible to the patient

Safe retriesIdempotency-Key on POST; predictable errors

IsolationPairwise patient ids per application

Data residencyEuropean Union: Google Cloud europe-west4

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

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.

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 · Sınırlar

Olaylar

resource.created, resource.updated, resource.deleted, consent.granted, consent.revoked, document.finalized ve ping için imzalı web kancaları. Web Kancaları

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, 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 bunları herhangi bir satıcıya sormanız gereken sorular haline getirir.

İlgili Konular

EHR API ve tıbbi kayıtlar API'si
Sağlık API platformu: Neler içerir ve nasıl seçilir
TypeScript ile sağlık API'si nasıl oluşturulur: Express ile adım adım öğretici
FHIR R4 kullanarak tıbbi kayıtlar nasıl saklanır: curl ile adım adım öğretici
Hasta onayı ile sağlık API'si
SMART on FHIR backend
Tıbbi veri API'si
FHIR platformu
Sağlık verisi birlikte çalışabilirliği
Sağlık entegrasyonları
API referansı (OpenAPI) · Kimlik Doğrulama ve OAuth

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