# Longitudinal hasta verileri API'si

> Bir hastanın kliniklerden, laboratuvarlardan, uygulamalardan ve cihazlardan zaman içindeki geçmişi: bir longitudinal kaydın gerektirdikleri ve bunu okumanın dört yolu — zaman çizelgesi, $everything, IPS ve AI bağlamı.

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

**Bir longitudinal hasta verileri API'si, bir kişinin zaman içindeki sağlık geçmişini — teşhisler, ilaçlar, laboratuvar sonuçları, yaşamsal belirtiler, aşılar ve her kaynaktan gelen ziyaretler — sağlayıcı başına ayrı belgeler yerine tek bir sıralı kayıt olarak döndürür.** Anpheros, bu geçmişi her sürümü ve her yazarı saklayarak, klinikler, laboratuvarlar, uygulamalar ve cihazlar tarafından yazılan, hasta başına tek bir HL7 FHIR R4 kaydı olarak tutar. Geliştiriciler bunu dört yolla okur: kronolojik bir zaman çizelgesi, `Patient/$everything` ile tam FHIR kaydı, bir Uluslararası Hasta Özeti veya yapay zeka modelleri için kompakt bir bağlam.

<!-- visual:longitudinal-sources -->

## "Boylamsal" ne anlama gelir

Sonuçların bir listesi henüz boylamsal bir kayıt değildir. Bir uygulamanın yıllara ve sağlayıcılara yayılan bir geçmişe güvenebilmesi için her girdinin şunları taşıması gerekir:

| Gereksinim | Neden önemlidir | Anpheros bunu nasıl saklar |
|---|---|---|
| Kodlanmış bir anlam | Farklı laboratuvarlardan gelen değerler karşılaştırılabilir olmalıdır | Sonuçlar için LOINC, durumlar için ICD-10, ilaçlar için ATC |
| Klinik bir tarih | Yüklenme zamanına değil, gerçekleşme zamanına göre sıralama | Her kaynakta `effective`, `onset`, `occurrence` tarihleri |
| Yazar | Bir doktorun teşhisi ve bir hastanın notu eşit değildir | Her yazmada Provenance: yazar türü, kişi, kuruluş, kaynak sistem |
| Her sürüm | Düzeltmeler daha önce bilinenleri silmemelidir | Her kaynakta sürüm geçmişi (`_history`) |
| Onay | Kişi onay verirse diğer uygulamalar geçmişi görür | Kapsamlar, geçerlilik süresi ve erişim günlüğü ile OAuth hibeleri |

## Tek kayıt, birden çok yazar

<!-- visual:longitudinal-timeline -->

## Geçmişi Okumanın Dört Yolu

| İhtiyaç | Uç Nokta | Ne Elde Edersiniz |
|---|---|---|
| Bir ekran için kronolojik bir akış | `GET /v1/patients/{id}/timeline` | Tarih, başlık, özet ve FHIR referansı ile sekiz türde öğe (gözlem, durum, ilaç, belge, karşılaşma, randevu, aşılama, epizot); `from`, `to`, `types` ile filtreleyin |
| FHIR olarak tam kayıt | `GET /fhir/R4/Patient/{id}/$everything` | Bir searchset Bundle'ı; `_since`, `_type`, `_count` ve `_offset` desteklenir |
| Paylaşılabilir bir klinik özet | `GET /fhir/R4/Patient/{id}/$summary` | Uluslararası Hasta Özeti (IPS) belgesi |
| Bir yapay zeka modeli için girdi | `POST /v1/context` | Bir token bütçesi içindeki bölümler, her gerçek kaynakla etiketlenmiş |

TypeScript SDK ile zaman çizelgesi:

```ts
import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });   // a sandbox key, sk_test_…
const { data: patients } = await anpheros.patients.list();
const page = await anpheros.timeline.list(patients[0].id, {
  from: '2025-01-01',
  types: 'condition,medication,observation',
  limit: 50,
});
for (const item of page.data) console.log(item.date, item.type, item.title);
```

Ve aynı kayıt FHIR olarak, bir tarihten bu yana değişenlerle sınırlı:

```bash
curl -H "Authorization: Bearer $ANPHEROS_KEY" \
  "https://platform.anpheros.com/fhir/R4/Patient/$PATIENT/\$everything?_since=2026-01-01&_type=Observation,Condition"
```

## Kopyanızı senkronize tutma

Uygulamanız geçmişin kendi görünümünü tutuyorsa, `resource.created`, `resource.updated` ve `resource.deleted` webhook'larına abone olun. Bunlar, başka bir proje sizin erişiminiz olan bir kayda yazdığında da tetiklenir; `data.external: true` ve yazan kişi `data.source` içinde yer alır, böylece diğer kliniklerden gelen veriler yoklama yapmadan size ulaşır.

## Bilmeniz Gereken Sınırlar

- Kayıt, içine yazılanları tutar. Anpheros, hastanelerden veya ulusal ağlardan kendi başına geçmişi çekmez; bunu klinikler, laboratuvarlar, uygulamalar ve kişi yazar.
- 26 FHIR R4 kaynak türü saklanır. Claim ve ExplanationOfBenefit gibi faturalandırma kaynakları saklanmaz.
- Diğer uygulamalar, kişinin geçmişini yalnızca kişinin rızasıyla okur; bir projenin kendi anahtarı, oluşturduğu hastaları görür.

## Sıkça Sorulan Sorular

### Boylamsal hasta verisi nedir?
Bir kişinin zaman içinde ve farklı bakım ortamlarında toplanan sağlık bilgileri — teşhisler, ilaçlar, sonuçlar, yaşamsal belirtiler, aşılar ve ziyaretler — tek bir sürekli geçmiş olarak okunabilmesi için saklanır.

### Hangi API, hastanın kaydının kronolojik bir görünümünü sağlar?
Anpheros'ta `GET /v1/patients/{id}/timeline`, sekiz kaynak türünden gelen girişleri tarih sırasına göre, sayfalama ve tarih ile tür filtreleriyle birlikte döndürür. Tam FHIR verisi için `Patient/$everything` kullanın.

### Geçmiş standart bir formatta mı saklanıyor?
Evet. Her giriş, standart kodlarla (LOINC, ICD-10, ATC, CVX, UCUM) HL7 FHIR R4 kaynağıdır ve özet Uluslararası Hasta Özeti'dir.

### Her bir girişi kimin yazdığını nasıl bilirim?
Her yazma işlemi, yazar türü (hasta, uygulayıcı, cihaz, içe aktarma veya YZ), kişi, kuruluş ve kaynak sistemi ile bir Provenance kaynağı oluşturur.

### Gerçekçi boylamsal verilerle test edebilir miyim?
Evet. Her sandbox projesi, yaklaşık altı aylık koşullar, ilaçlar, laboratuvar sonuçları ve yaşamsal belirtiler içeren 30 sentetik hasta ile başlar.

<!-- visual:cta-longitudinal -->

## İlgili Kaynaklar

- [FHIR ile Kişisel Sağlık Kaydı (PHR) uygulaması](https://developers.anpheros.com/tr/guides/personal-health-record-app): Gerçek bir uygulamada zaman çizelgesi
- [Tıbbi Veri Kaynağının Açıklaması](https://developers.anpheros.com/tr/guides/medical-data-provenance)
- [Sağlık Uygulamaları İçin Hasta Onay Platformu](https://developers.anpheros.com/tr/guides/patient-consent-platform)
- [FHIR R4 Kullanarak Tıbbi Kayıtların Nasıl Saklanacağı](https://developers.anpheros.com/tr/guides/store-medical-records-fhir)
- [Yapay Zeka Ajanları ve Tıbbi Veriler](https://developers.anpheros.com/tr/guides/ai-agents-medical-data): bağlam uç noktası
- [Webhook'lar](https://developers.anpheros.com/tr/guides/webhooks)