Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Sağlık Verisi API'si
Her tür sağlık verisinin Anpheros API'sinde nereye gittiği, nasıl kodlandığı ve nasıl yazılacağı, filtreleneceği, izleneceği, düzeltileceği ve silineceği — çalışan örneklerle.
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 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 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
# 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(sistolik8480-6, diyastolik8462-4panelin85354-9içinde) kullanır. - Yazar türleri:
patient,practitioner,device,import,ai. Bunlardan biri olmadan platformimportkaydeder. - Ezbere bilmediğiniz kodlar:
GET /v1/terminology/loinc?q=hba1c, paketlenmiş LOINC alt kümesini veGET /v1/search?q=metforminbelirti, 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
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).
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çinIf-Matchile 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}; birPatientsilmek 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: kodlar, birimler, tarihler, tekrarlar, doğrulama
- Tıbbi veri kökeni açıklandı: kimin ne yazdığı ve bunu nasıl kaydedeceğiniz
- Sağlık API'si
- Hasta tıbbi kaydı
- Sağlık uygulaması oluşturma
- API referansı (OpenAPI) · Başlarken
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card