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

واجهة برمجة تطبيقات بيانات المريض الطولية

Q: أي واجهة برمجة تطبيقات (API) توفر عرضًا زمنيًا لسجل المريض؟

في Anpheros، GET /v1/patients/{id}/timeline تُرجع إدخالات من ثمانية أنواع موارد بترتيب التاريخ، مع التصفح والترشيح حسب التاريخ والنوع. للحصول على بيانات FHIR الكاملة، استخدم Patient/$everything.

تاريخ مريض واحد عبر الزمن من العيادات والمختبرات والتطبيقات والأجهزة: ما يحتاجه السجل الطولي، وأربع طرق لقراءته — الخط الزمني، $everything، IPS، وسياق الذكاء الاصطناعي.

تعيد واجهة برمجة تطبيقات بيانات المريض الطولية التاريخ الصحي لشخص واحد بمرور الوقت — التشخيصات والأدوية ونتائج المختبر والعلامات الحيوية والتطعيمات والزيارات من كل مصدر — كسجل واحد مرتب بدلاً من مستندات منفصلة لكل مزود. تحتفظ Anpheros بهذا التاريخ كسجل HL7 FHIR R4 واحد لكل مريض، مكتوب بواسطة العيادات والمختبرات والتطبيقات والأجهزة، مع الاحتفاظ بكل إصدار وكل مؤلف. يقرأ المطورون هذا السجل بأربع طرق: خط زمني مرتب زمنيًا، سجل FHIR الكامل مع Patient/$everything، ملخص المريض الدولي (IPS)، أو سياق مضغوط لنماذج الذكاء الاصطناعي.

Many sources, one longitudinal record

ClinicsVisits, diagnoses and prescriptions as FHIR R4
LaboratoriesHL7 v2, CSV or JSON reports become Observations
Apps and devicesReadings from phones, watches and home devices
One FHIR recordEvery version kept, every write with provenance
Your applicationTimeline, $everything, IPS summary or AI context

ما يتطلبه "السجل الطولي"

قائمة النتائج ليست سجلاً طوليًا بعد. لكي تثق التطبيقات في سجل يمتد لسنوات ومقدمي خدمات متعددين، يجب أن يحمل كل إدخال:

المتطلب	لماذا هو مهم	كيف يخزن Anpheros ذلك
معنى مُرمز	يجب أن تكون القيم من مختبرات مختلفة قابلة للمقارنة	LOINC للنتائج، ICD-10 للحالات، ATC للأدوية
تاريخ سريري	الترتيب حسب وقت حدوثه، وليس وقت تحميله	تواريخ `effective`، `onset`، `occurrence` على كل مورد
المؤلف	تشخيص الطبيب وملاحظة المريض ليسا متساويين	Provenance عند كل كتابة: نوع المؤلف، الشخص، المنظمة، نظام المصدر
كل إصدار	يجب ألا تمحو التصحيحات ما كان معروفًا من قبل	سجل الإصدارات على كل مورد (`_history`)
الموافقة	ترى التطبيقات الأخرى السجل فقط إذا وافق الشخص	منح OAuth مع نطاقات (scopes)، وانتهاء الصلاحية، وسجل وصول

سجل واحد، عدة كتاب

One patient, many writers, one timeline (illustrative data)

Mar 2019Type 2 diabetesCondition · ICD-10 E11 · written by the GP practice
Mar 2019Metformin 500 mgMedicationStatement · ATC A10BA02
Sep 2023HbA1c 7.4 %Observation · LOINC 4548-4 · imported from the laboratory
Oct 2024Influenza vaccineImmunization · written by the pharmacy
Jun 2026Cardiology visitEncounter · written by the clinic
Oct 2026Blood pressure 138/86 mmHgObservation · from the patient's app

Condition Medication Observation Immunization Encounter

أربع طرق لقراءة السجل التاريخي

الحاجة	نقطة النهاية (Endpoint)	ما تحصل عليه
موجز زمني للشاشة	`GET /v1/patients/{id}/timeline`	عناصر من ثمانية أنواع (observation, condition, medication, document, encounter, appointment, immunization, episode) مع التاريخ، العنوان، الملخص، ومرجع FHIR؛ قم بالفلترة باستخدام `from`، `to`، `types`
السجل الكامل بصيغة FHIR	`GET /fhir/R4/Patient/{id}/$everything`	حزمة بحث (searchset Bundle)؛ يتم دعم `_since`، `_type`، `_count` و `_offset`
ملخص سريري قابل للمشاركة	`GET /fhir/R4/Patient/{id}/$summary`	مستند الملخص الدولي للمريض (International Patient Summary - IPS)
مدخلات لنموذج ذكاء اصطناعي	`POST /v1/context`	أقسام ضمن ميزانية رمز (token budget)، كل حقيقة مُصنفة بمصدرها

الخط الزمني باستخدام TypeScript SDK:

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);

ونفس السجل بصيغة FHIR، محدود بما تغير منذ تاريخ معين:

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

الحفاظ على مزامنة نسختك

إذا كان تطبيقك يحتفظ بمنظوره الخاص للسجل التاريخي، فاشترك في خطافات الويب resource.created و resource.updated و resource.deleted. يتم تشغيلها أيضًا عندما يكتب مشروع آخر في سجل لديك حق الوصول إليه، مع data.external: true والكاتب في data.source، بحيث تصل البيانات من العيادات الأخرى إليك دون الحاجة إلى الاستقصاء.

حدود جديرة بالمعرفة

السجل يحتفظ بما تم كتابته فيه. Anpheros لا تجلب السجل من المستشفيات أو الشبكات الوطنية بنفسها؛ العيادات والمختبرات والتطبيقات والشخص نفسه هم من يكتبون.
يتم تخزين 26 نوعًا من موارد FHIR R4. موارد الفوترة مثل Claim و ExplanationOfBenefit لا يتم تخزينها.
التطبيقات الأخرى تقرأ سجل الشخص فقط بموافقة ذلك الشخص؛ مفتاح المشروع الخاص يرى المرضى الذين أنشأهم.

أسئلة متكررة

ما هي بيانات المريض الطولية؟

معلومات صحة الشخص التي تم جمعها بمرور الوقت وعبر أماكن الرعاية - التشخيصات، الأدوية، النتائج، العلامات الحيوية، التطعيمات والزيارات - يتم الاحتفاظ بها بحيث يمكن قراءتها كسجل مستمر واحد.

أي واجهة برمجة تطبيقات (API) توفر عرضًا زمنيًا لسجل المريض؟

في Anpheros، GET /v1/patients/{id}/timeline تُرجع إدخالات من ثمانية أنواع موارد بترتيب التاريخ، مع التصفح والترشيح حسب التاريخ والنوع. للحصول على بيانات FHIR الكاملة، استخدم Patient/$everything.

هل يتم تخزين السجل بتنسيق قياسي؟

نعم. كل إدخال هو مورد HL7 FHIR R4 برموز قياسية (LOINC, ICD-10, ATC, CVX, UCUM)، والملخص هو ملخص المريض الدولي (International Patient Summary).

كيف أعرف من كتب كل إدخال؟

كل عملية كتابة تنشئ مورد Provenance مع نوع المؤلف (مريض، ممارس، جهاز، استيراد أو ذكاء اصطناعي)، الشخص، المنظمة، ونظام المصدر.

هل يمكنني الاختبار ببيانات طولية واقعية؟

نعم. تبدأ كل مشروع Sandbox بـ 30 مريضًا اصطناعيًا لديهم حوالي ستة أشهر من الحالات، والأدوية، ونتائج المختبر، والعلامات الحيوية.