# Tıbbi Veri API'si

> Anpheros API'sinde her tür tıbbi verinin nereye gittiği, nasıl kodlandığı ve nasıl yazılacağı, filtreleneceği, izleneceği, düzeltileceği ve silineceği — çalışan örneklerle birlikte.

Source: https://developers.anpheros.com/tr/guides/medical-data-api

**Tıbbi bir veri API'si, yazılımlara hasta kayıtlarının içeriğine yapılandırılmış erişim sağlar: bir hasta oluşturma, bir kan basıncı okuması kaydetme, aktif ilaçları listeleme, bir laboratuvar raporu ekleme, kimin ne yazdığını izleme.** Bu sayfa, Anpheros API'sinin veri işlemlerini — hangi tür tıbbi verinin nereye gittiği, nasıl kodlandığı ve nasıl geri okunacağı — sandbox'a karşı çalışan örneklerle birlikte açıklar.

Uygulamalar, Anpheros'u ürünlerinin tıbbi veritabanı olarak kullanmak için bu işlemleri kullanır: hasta kayıtları platformun HL7 FHIR R4 deposunda yaşar ve uygulama, kendi tıbbi veri tablolarını tutmak yerine API aracılığıyla bunları okur ve yazar.

Daha geniş resim (kimlik doğrulama, onay, olaylar) için [Sağlık Hizmetleri API'sine](https://developers.anpheros.com/tr/guides/healthcare-api) bakın.

## Tıbbi Verinin Konumu

| Tıbbi Veri | REST v1 | FHIR Kaynağı | Kodlama |
|---|---|---|---|
| Kişi | `POST /v1/patients` | `Patient` | isim, doğum tarihi, cinsiyet, kimlik bilgileri |
| Yaşamsal bulgular, laboratuvar sonuçları, semptomlar, aktivite, anketler | `/v1/patients/{id}/observations` | `Observation` | LOINC (semptomlar: ICD-10 bölüm R); UCUM birimleri |
| Tanılar ve problemler | `/v1/patients/{id}/conditions` | `Condition` | ICD-10 |
| İlaçlar | `/v1/patients/{id}/medications` | `MedicationStatement` | ATC, ürün adı metin olarak saklanır |
| Belgeler (PDF, resimler) | `/v1/patients/{id}/documents` | `DocumentReference` | LOINC belge türleri |
| Tam bir laboratuvar raporu | `POST /v1/patients/{id}/labs/import` | `Observation` (laboratuvar) | Biliniyorsa LOINC, aksi takdirde laboratuvarın kendi kodu |
| Alınan veya atlanan dozlar, aşılar, alerjiler, prosedürler, raporlar, bakım planları, hedefler, sevkler, ziyaretler, randevular, bakım ekipleri, aile öyküsü, anketler | `/fhir/R4/{type}` | `MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse` | [FHIR kod sistemlerine](https://developers.anpheros.com/tr/guides/fhir-code-systems) göre |

REST v1 nesneleri ve FHIR kaynakları aynı kimliklere sahip aynı kayıtlardır; her v1 nesnesi `fhir` referansını taşır.

## Tıbbi Veri Yazma

```bash
# a lab result with its reference range, linked to the report it came from
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": "4548-4", "display": "Hemoglobin A1c", "category": "laboratory",
  "value": 6.4, "unit": "%", "effective_at": "2026-09-01T08:00:00Z",
  "reference_range": {"low": 4.0, "high": 5.6},
  "derived_from": ["DocumentReference/'$DOC'"], "author_type": "import"
}'
```

- **Gözlem kategorileri:** `vital-signs`, `laboratory`, `symptom`, `activity`, `survey`, `exam`, `imaging`, `social-history`.
- **Bileşik ölçümler** (örneğin kan basıncı) `components` (sistolik `8480-6`, diyastolik `8462-4` panelin `85354-9` içinde) kullanır.
- **Yazar türleri:** `patient`, `practitioner`, `device`, `import`, `ai`. Bunlardan biri olmadan platform `import` kaydeder.
- **Ezbere bilmediğiniz kodlar:** `GET /v1/terminology/loinc?q=hba1c`, paketlenmiş LOINC alt kümesini ve `GET /v1/search?q=metformin` belirti, durum ve ilaç kataloğunu arar; bir görüntü adı olmadan yazılan bir gözlem otomatik olarak LOINC adını alır.

## Tıbbi Veri Okuma

```bash
curl "https://platform.anpheros.com/v1/patients/$PID/observations?category=laboratory&code=4548-4&from=2026-01-01" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/conditions?clinical_status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"
```

| Endpoint | Filtreler |
|---|---|
| observations | `category`, `code`, `from`, `to` |
| conditions | `clinical_status` |
| medications | `status` |
| documents | `kind` |
| timeline | `from`, `to`, `types` |

Listeler `limit` ve `cursor` ile sayfalandırılır. **timeline** endpoint'i, gözlemleri, durumları, ilaçları, belgeleri, ziyaretleri, randevuları, aşıları ve bakım epizotlarını tek bir kronolojik listede birleştirir — hasta geçmişi ekranı için doğal bir giriş noktasıdır.

REST filtrelerinin kapsamadığı her şey için FHIR aramayı kullanın: `GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date` ([FHIR platformu](https://developers.anpheros.com/tr/guides/fhir)).

## Veri İzleme ve Düzeltme

- **Kim Yazdı:** `GET /v1/patients/{id}/provenance/{type}/{resourceId}` — her sürüm için bir giriş, yazar türü, proje, kuruluş ve kaynak sistemi ile birlikte.
- **Her Sürüm:** `GET /fhir/R4/{type}/{id}/_history`; başkasının yaptığı değişikliğin üzerine yazmaktan kaçınmak için `If-Match` ile güncelleyin.
- **Sahiplik:** Onay ile diğer kuruluşların yazdıklarını okuyabilirsiniz, ancak yalnızca projenizin yazdığını değiştirebilir veya silebilirsiniz (aksi takdirde `403`).
- **Silme:** `DELETE /v1/{observations|conditions|medications}/{id}`; bir `Patient` silmek tüm kaydı siler.

## Belgeler

Belgeyi oluşturun (bir yükleme hedefi alırsınız), baytları platform aracılığıyla veya doğrudan depolama alanına yükleyin, ardından sonlandırın. Sonlandırmadan sonra orijinali değiştirilemez hale gelir; SHA-256 karması ve boyutu kaydedilir. Dosya başına en fazla 25 MiB.

## İlgili Konular

- [Tıbbi verileri normalleştirme](https://developers.anpheros.com/tr/guides/normalize-medical-data): kodlar, birimler, tarihler, tekrarlar, doğrulama
- [Tıbbi veri kökeni açıklandı](https://developers.anpheros.com/tr/guides/medical-data-provenance): kimin ne yazdığı ve bunu nasıl kaydedeceğiniz
- [Sağlık API'si](https://developers.anpheros.com/tr/guides/healthcare-api)
- [Hasta tıbbi kaydı](https://developers.anpheros.com/tr/guides/patient-medical-record)
- [Sağlık uygulaması oluşturma](https://developers.anpheros.com/tr/guides/build-a-healthcare-app)
- [API referansı (OpenAPI)](https://developers.anpheros.com/docs) · [Başlarken](https://developers.anpheros.com/tr/guides/getting-started)