# FHIR platform: hasta rızasıyla yönetilen FHIR R4

> Yönetilen bir FHIR R4 platformu: 26 kaynak türü, arama, geçmiş, işlemler, $everything, IPS, Inferno-testli SMART başlatma, rıza ve köken bilgisi, artı basit bir REST API. Ücretsiz deneme ortamı.

Source: https://developers.anpheros.com/tr/guides/fhir

**Anpheros bir FHIR platformudur — uygulamaların FHIR arka ucu olarak kullandığı yönetilen bir FHIR veritabanı (veri deposu): her hasta kaydını yerel olarak HL7 FHIR R4 (4.0.1) kaynakları olarak depolar ve standartın üzerine rıza, köken bilgisi ve denetim ekleyerek `https://platform.anpheros.com/fhir/R4` adresinde sunar.** Zaten FHIR konuşan uygulamalar doğrudan kullanabilir; konuşmayanlar ise aynı kimliklerle aynı kaynakları okuyup yazan daha basit REST API'yi (`/v1`) kullanabilir.

Yapay zeka uygulamaları için bu, Anpheros'u bir modelin bağlamının geldiği FHIR arka ucu yapar: [LLM uygulamaları ve sağlık verileri](https://developers.anpheros.com/tr/guides/llm-healthcare-data) bölümüne bakın.

<!-- visual:fhir-hero -->

## HL7 FHIR Nedir?

FHIR (Fast Healthcare Interoperability Resources), web üzerinden sağlık verilerinin alışverişi için HL7 standardıdır. Aşağıdakileri tanımlar:

- **kaynaklar** — her klinik kavram için küçük, tipli JSON (veya XML) belgeler: bir `Patient`, bir `Observation`, bir `Condition`, bir `MedicationStatement`;
- aralarındaki **referanslar** (`"subject": {"reference": "Patient/123"}`), böylece bir kayıt bir hasta etrafındaki kaynakların bir grafiğidir;
- kaynakları okumak, aramak, oluşturmak, güncellemek ve silmek için standart arama parametreleriyle bir **REST API**;
- kaynakları tek seferde (işlemler) veya bir belge olarak (bir hasta özeti gibi) göndermek için **paketler**;
- LOINC veya ICD-10 gibi sistemlerden gelen kodları taşıyan değerler için **terminoloji bağlamaları**;
- belirli bir kullanım durumu veya ülke için kısıtlamalar, örneğin International Patient Summary gibi **profiller**.

R4 (sürüm 4.0.1), bugün en yaygın uygulanan sürümdür. FHIR'ı depolama modeli olarak kullanmak — yalnızca bir dışa aktarma formatı olarak değil — bir uygulamanın yazdığı ile başka bir FHIR sisteminin okuduğu arasında bir çeviri katmanı olmadığı anlamına gelir.

```json
{
  "resourceType": "Observation",
  "status": "final",
  "category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "laboratory"}]}],
  "code": {"coding": [{"system": "http://loinc.org", "code": "4548-4", "display": "Hemoglobin A1c"}]},
  "subject": {"reference": "Patient/…"},
  "effectiveDateTime": "2026-09-01T08:00:00Z",
  "valueQuantity": {"value": 6.4, "unit": "%", "system": "http://unitsofmeasure.org", "code": "%"}
}
```

## Yetenek Bildirimi

`GET /fhir/R4/metadata`, desteklenen kaynak türlerini, arama parametrelerini ve işlemleri içeren CapabilityStatement'ı döndürür. Bu, herkese açık ve yetkili listedir; aşağıdaki tablo 28 Eylül 2026 itibarıyla bunu yansıtmaktadır.

## 26 kaynak türü

<!-- visual:fhir-map:replace -->

| Alan | Kaynak türleri |
|---|---|
| Hasta ve kişiler | `Patient`, `RelatedPerson` |
| Ölçümler ve sonuçlar | `Observation` (vital bulgular, laboratuvar, semptomlar, refah, günlük aktivite ve uyku), `DiagnosticReport` |
| Sorunlar ve bakım | `Condition`, `EpisodeOfCare`, `Procedure`, `CarePlan`, `Goal`, `ServiceRequest`, `CareTeam`, `FamilyMemberHistory` |
| İlaç ve önleme | `MedicationStatement`, `MedicationAdministration`, `Immunization`, `AllergyIntolerance` |
| Belgeler ve anketler | `DocumentReference`, `QuestionnaireResponse` |
| Ziyaretler | `Encounter`, `Appointment` |
| Dizin | `Organization`, `Practitioner`, `PractitionerRole` |
| Yönetişim | `Consent`, `Provenance` |
| Uzantı noktası | `Basic` |

Her hasta kapsamındaki tür, hasta bölmesine aittir, bu nedenle `Patient/{id}/$everything`, hasta düzeyindeki OAuth kapsamları ve onay filtreleri bunların tümü için geçerlidir. Dizin kaynaklarının (`Organization`, `Practitioner`, `PractitionerRole`) hastası yoktur; aynı ortamdaki projeler arasında okunabilirler ve yalnızca onları oluşturan proje tarafından değiştirilebilirler.

## Etkileşimler ve Operasyonlar

<!-- visual:fhir-ops -->

- Desteklenen her tür üzerinde **okuma, arama, oluşturma, güncelleme, silme**; türe göre arama parametreleri CapabilityStatement'ta listelenmiştir. Bilinmeyen arama parametreleri sessizce yoksayılmak yerine `400` ile reddedilir.
- **Geçmiş**: `GET /fhir/R4/{type}/{id}/_history` her sürümü döndürür; güncellemeler `If-Match` ile koşullu hale getirilebilir (sürüm uyumsuzluğu `412` ile yanıt verir).
- **İşlemler ve toplu işler**: `transaction` veya `batch` türünde bir `Bundle` ile `POST /fhir/R4`.
- **`Patient/{id}/$everything`**: tek bir hastanın tüm bölmesi.
- **`Patient/{id}/$summary`**: İngilizce veya Rumence (`?lang=`) bir Uluslararası Hasta Özeti (IPS) belgesi `Bundle`.
- **`Observation/$validate?profile=eu-lab`**: bir laboratuvar sonucunun HL7 Europe laboratuvar rapor kurallarına nasıl uyduğunu bildirir.
- **Sayfalama**: 200'e kadar `_count`; `_revinclude` en fazla 1.000 kaynak döndürür.
- **Tekrarlanabilirlik**: `POST` istekleri bir `Idempotency-Key` kabul eder; aynı anahtarla bir isteği tekrarlamak aynı yanıtı döndürür ve hiçbir şey oluşturmaz.

```bash
# latest HbA1c results of one patient, strict FHIR
curl "https://platform.anpheros.com/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" \
     -H "Authorization: Bearer $KEY"

# the patient's International Patient Summary
curl "https://platform.anpheros.com/fhir/R4/Patient/$PID/\$summary?lang=en" -H "Authorization: Bearer $KEY"
```

## FHIR ve Daha Basit REST API

`/v1`, FHIR kaynaklarıyla doğrudan çalışmak istemeyen geliştiriciler için mevcuttur. Hastalar, gözlemler, durumlar, ilaçlar, belgeler, kronolojik bir zaman çizelgesi ve köken bilgileri ile platform özelliklerini (bağlam, laboratuvar içe aktarma, webhook'lar, terminoloji) kapsar. Her `/v1` nesnesi `fhir` referansını taşır, böylece bir uygulama `/v1` ile başlayıp tam modele ihtiyaç duyduğu kısımlar için FHIR'a geçiş yapabilir.

## FHIR Etrafındaki Standartlar

`$summary`, resmi HL7 doğrulayıcısı ile doğrulanmış bir Uluslararası Hasta Özeti (0 hata) üretir; laboratuvar sonuçları HL7 Europe laboratuvar kurallarına göre kontrol edilir (bugün tavsiye niteliğinde); üçüncü taraf uygulamalar SMART on FHIR standalone launch aracılığıyla bağlanır; HL7 v2 `ORU^R01` laboratuvar mesajları girdi olarak kabul edilir. Formatlar, seviyeler ve değişim desenleri [Sağlık verisi birlikte çalışabilirliği](https://developers.anpheros.com/tr/guides/interoperability) bölümünde açıklanmıştır; kaynak türüne göre kod sistemleri [FHIR kod sistemleri](https://developers.anpheros.com/tr/guides/fhir-code-systems) bölümünde açıklanmıştır.

## Sıkça Sorulan Sorular

### FHIR platformu nedir?
Sağlık verilerini HL7 FHIR kaynakları olarak depolayan ve standart FHIR REST API aracılığıyla sunan bir hizmettir. Uygulamaların standart etrafında ihtiyaç duyduğu yetkilendirme, onay, denetim, geçmiş ve `$everything` ve `$summary` gibi işlemleri ekler. Anpheros, yönetilen bir FHIR R4 platformudur: bir FHIR sunucusu çalıştırmak yerine onu çağırırsınız.

### FHIR sunucusu ile FHIR platformu arasındaki fark nedir?
FHIR sunucusu, bir veritabanı üzerinde FHIR API'sini uygular. FHIR platformu bunu sizin için çalıştırır ve etrafındaki katmanı ekler — hasta onayı, köken bilgisi, erişim günlükleri, SDK'lar, webhook'lar, laboratuvar içe aktarma ve bir sandbox — böylece uygulamaların bu kısımları oluşturması gerekmez.

### Anpheros hangi FHIR sürümünü destekliyor?
FHIR R4 (4.0.1), `/fhir/R4/metadata` adresindeki genel CapabilityStatement'ta listelenen 26 kaynak türü ile.

### Anpheros FHIR platformu bağımsız olarak test ediliyor mu?
Açık kaynaklı Inferno test kitinin SMART App Launch STU2 "Standalone Launch" grubu, 22 testin 22'sini (28 Eylül 2026 çalıştırması) geçiyor ve International Patient Summary, resmi HL7 doğrulayıcısında 0 hata ile doğrulanıyor. EHR başlatma ve Bulk Data dışa aktarma henüz desteklenmiyor.

### FHIR platformunu ücretsiz kullanabilir miyim?
Evet. Sandbox ücretsizdir ve proje başına 30 sentetik hasta içerir; üretim, ilk ay ücretsiz olmak üzere ayda 99 €'dan başlar.

### Anpheros'u kullanmak için FHIR kullanmak zorunda mıyım?
Hayır. Daha basit bir REST API (`/v1`), aynı kimliklerle aynı kaynakları okur ve yazar, böylece bir uygulama düz JSON ile başlayabilir ve tam modele ihtiyaç duyduğunda FHIR'a geçebilir.

<!-- visual:cta-fhir -->

## İlgili Kaynaklar

- [FHIR sandbox](https://developers.anpheros.com/tr/guides/fhir-sandbox): ücretsiz özel bir FHIR R4 test sunucusu
- [Uluslararası Hasta Özeti (IPS) FHIR formatında](https://developers.anpheros.com/tr/guides/international-patient-summary-fhir)
- [Tıbbi veri kökenbilimi (provenance) açıklaması](https://developers.anpheros.com/tr/guides/medical-data-provenance): kim neyi yazdı ve bunu nasıl kaydedersiniz
- [FHIR R4 kullanarak tıbbi kayıtlar nasıl saklanır](https://developers.anpheros.com/tr/guides/store-medical-records-fhir): curl ile adım adım öğretici
- [FHIR ve özel bir tıbbi veritabanı karşılaştırması](https://developers.anpheros.com/tr/guides/fhir-vs-custom-database): kendi tablolarınızı ne zaman tasarlamalısınız ve ne zaman FHIR kullanmalısınız
- [Ücretsiz FHIR veritabanı ve sandbox](https://developers.anpheros.com/tr/guides/free-fhir-database)
- [Anpheros diğer FHIR sunucularıyla nasıl karşılaştırılır](https://developers.anpheros.com/tr/guides/fhir-server-comparison)
- [Sağlık verisi birlikte çalışabilirliği](https://developers.anpheros.com/tr/guides/interoperability)
- [FHIR kod sistemleri](https://developers.anpheros.com/tr/guides/fhir-code-systems)
- [Tıbbi veri API'si](https://developers.anpheros.com/tr/guides/medical-data-api)
- [Bir sağlık uygulaması oluşturun](https://developers.anpheros.com/tr/guides/build-a-healthcare-app)
- [API referansı (OpenAPI)](https://developers.anpheros.com/docs)
- [DICOM ve FHIR karşılaştırması](https://developers.anpheros.com/tr/guides/dicom-vs-fhir): FHIR nerede biter ve tıbbi görüntüleme nerede başlar