واجهة برمجة تطبيقات بيانات الرعاية الصحية: ما الذي تبحث عنه، وكيف تقرأ وتكتب سجل مريض في ساعة واحدة

"واجهة برمجة تطبيقات الرعاية الصحية" تغطي أشياء مختلفة جدًا: تدفق بيانات HL7 v2 الخاص بالمستشفى، خدمة وصفات طبية إلكترونية وطنية، تصدير من مورّد جهاز قابل للارتداء، خادم FHIR. إذا كنت تبني تطبيقًا صحيًا، أو أداة للعيادة، أو مساعد ذكاء اصطناعي، فما تحتاجه أضيق: خلفية تحتفظ بسجل المريض بتنسيق قياسي، وتسمح للمريض بتحديد من يقرأه، وتوفر لك واجهة برمجة تطبيقات نظيفة فوقه. هذا الدليل يوضح ما تبحث عنه ويُظهر، مع استدعاءات حقيقية، كيف تبدو الساعة الأولى على منصة Anpheros.

نسخة تقنية للمطورين: واجهة برمجة تطبيقات الرعاية الصحية · واجهة برمجة تطبيقات البيانات الطبية على developers.anpheros.com، مع الطلبات والاستجابات والحدود. هذه الصفحة هي النسخة بلغة بسيطة.

ما يجب أن تقوم به واجهة برمجة تطبيقات بيانات الرعاية الصحية

خمسة أشياء تفصل واجهة برمجة تطبيقات بيانات صحية قابلة للاستخدام عن قاعدة بيانات مع HTTP أمامها.

• تنسيق قياسي. HL7 FHIR R4 هو التنسيق الذي تستخدمه المستشفيات والأنظمة الوطنية ومساحة بيانات الصحة في الاتحاد الأوروبي. يمكن قراءة السجل المخزن بتنسيق FHIR بواسطة أنظمة أخرى دون الحاجة إلى جسر مخصص. أما تنسيق JSON مملوك لجهة واحدة فلا يمكن قراءته بهذه الطريقة.
• موافقة المريض ككائن من الدرجة الأولى. من يُسمح له بالقراءة، وماذا، ولأي مدة، وقابل للإلغاء، ومرئي للمريض. ليس مجرد مربع اختيار في قاعدة بياناتك الخاصة.
• المصدر (Provenance). كل قيمة تقول من كتبها: المريض، ممارس، جهاز، استيراد، حساب مشتق. مساعد الذكاء الاصطناعي الذي لا يستطيع التمييز بين نتيجة مختبر وتخمين تم الإبلاغ عنه ذاتيًا هو خطير.
• بيئة اختبار (sandbox) ببيانات واقعية. لا يمكنك الاختبار مع مرضى حقيقيين، ولا يجب عليك اختراع 30 مريضًا اصطناعيًا بسجل يمتد لستة أشهر بنفسك.
• موقع البيانات الذي يمكنك تسميته. بالنسبة للمستخدمين الأوروبيين، هذا يعني خوادم في الاتحاد الأوروبي، تحت GDPR، مع اتفاقية معالجة بيانات.

طريقتان للدخول: REST و FHIR، نفس البيانات

تعرض منصة Anpheros نفس السجل مرتين. واجهة برمجة تطبيقات REST بسيطة (/v1) لشيفرة منتجك البرمجية، و FHIR R4 صارمة (/fhir/R4) لأي شيء يجب أن يتحدث مع بقية النظام الصحي. المعرفات متطابقة في كليهما؛ كل كائن v1 يحمل مرجع fhir الخاص به.

export BASE=https://platform.anpheros.com
export KEY=sk_test_…

# المرضى الذين يمكن لمشروعك رؤيتهم
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# نتائج المختبر، الأحدث أولاً
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# الأدوية النشطة
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# كل شيء على جدول زمني واحد
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# نفس البيانات، FHIR صارم
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

خلف هذه الاستدعاءات توجد 26 نوعًا من موارد FHIR (Patient, Observation, Condition, MedicationStatement, AllergyIntolerance, Immunization, DocumentReference, Encounter, Consent, Provenance والمزيد)، مرمزة باستخدام LOINC للقياسات، و ICD-10 للحالات، و ATC للأدوية.

الحصول على مفتاح يستغرق دقيقة واحدة

بيئة الاختبار مجانية وذاتية الخدمة. قم بتسجيل الدخول إلى لوحة التحكم على platform.anpheros.com/dashboard، اضغط على Get a sandbox key (الحصول على مفتاح بيئة اختبار)، وستحصل على مؤسسة، ومشروع بيئة اختبار، ومفتاح sk_test_…. يأتي المشروع مع نسخته الخاصة من 30 مريضًا اصطناعيًا: بالغين وأطفال وكبار السن من جميع أنحاء الاتحاد الأوروبي، مع حالات وأدوية وحساسية ونتائج مختبر وعلامات حيوية على مدى ستة أشهر. قم بتغيير أو حذف أي شيء؛ إعادة الضبط تعيدهم.

مفاتيح الإنتاج (sk_live_…) تذهب إلى المؤسسات التي تم التحقق منها والتي وقّعت اتفاقية معالجة بيانات موقعة. بيئة الاختبار والإنتاج هما قاعدتا بيانات مختلفتان: مفتاح بيئة الاختبار لا يمكنه الوصول فعليًا إلى مريض حقيقي.

ماذا يتضمن أيضاً

• OAuth 2.1 مع PKCE و SMART on FHIR بإطلاق مستقل (standalone launch)، حتى يتمكن التطبيق من طلب الوصول إلى سجل الشخص الخاص به.
• الموافقة مع النطاقات (scopes) وانتهاء الصلاحية والإلغاء، وسجل وصول يمكن للمريض قراءته.
• خطافات الويب الموقعة (HMAC-SHA256، مع إعادة المحاولة بفواصل زمنية متزايدة) لـ resource.created، consent.granted، consent.revoked، document.finalized.
• واجهة برمجة تطبيقات سياق الذكاء الاصطناعي التي تبني ملخصًا للمريض مع تسميات المصدر ضمن ميزانية محددة من الرموز (tokens).
• استيراد تقارير المختبر من CSV، HL7 v2 ORU^R01 أو JSON، مع تعيينها إلى LOINC.
• ملخص المريض الدولي (International Patient Summary) ($summary) و SMART Health Links للمشاركة عبر QR.
• حزم تطوير البرامج (SDKs) لـ Dart و TypeScript، ومرجع OpenAPI على /docs وبيان القدرة (CapabilityStatement) على /fhir/R4/metadata.

الشرح الكامل، مع الاستجابات، متاح على developers.anpheros.com/guides/first-hour.

الأسئلة الشائعة

Anpheros Platform

جرّبه مجانًا في بيئة الاختبار

أول طلب FHIR خلال 5 دقائق. واجهة برمجة تطبيقات HL7 FHIR R4 مع موافقة المريض مدمجة: جربها في بيئة الاختبار، ثم اربط تطبيقك الخاص أو نظام عيادتك.

أنشئ بيئة اختبار مجانيةاقرأ أدلة المطورين →

مجاني · 30 مريضًا اصطناعيًا · دون بطاقة

بقلم

Anpheros Editorial Team

تبني Anpheros سجلًا طبيًا يتحكم فيه المريض ويمكن مشاركته مع أي عيادة، على منصة HL7 FHIR R4، مقرها في الاتحاد الأوروبي. تساعدك هذه الأدلة على فهم وتنظيم صحتك؛ ولا تغني عن استشارة طبيبك.

عن Anpheros →