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

"واجهة برمجة تطبيقات الرعاية الصحية" تغطي أشياء مختلفة جدًا: تغذية 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، اضغط على الحصول على مفتاح بيئة اختبار، وستحصل على مؤسسة، ومشروع بيئة اختبار، ومفتاح sk_test_…. يأتي المشروع مع نسخته الخاصة من 30 مريضًا اصطناعيًا: بالغين وأطفال وكبار السن من جميع أنحاء الاتحاد الأوروبي، مع حالات وأدوية وحساسية ونتائج مختبر وعلامات حيوية على مدى ستة أشهر. قم بتغيير أو حذف أي شيء؛ إعادة الضبط تعيدهم.

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

ما هو الآخر في الصندوق

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

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

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

هل هناك واجهة برمجة تطبيقات رعاية صحية مجانية يمكنني البدء بها اليوم؟

نعم. بيئة اختبار Anpheros مجانية وتخدم ذاتيًا: قم بتسجيل الدخول، احصل على مفتاح، وستحصل على 30 مريضًا اصطناعيًا للقراءة والكتابة. الحدود هي 10000 كتابة مورد في اليوم، و 100 مريض خاص بك، و 250 ميجابايت من المستندات لكل مشروع.

REST أم FHIR، أيهما يجب أن أستخدم؟

استخدم /v1 لرمز منتجك الخاص: فهو أبسط ويعيد JSON عاديًا. استخدم /fhir/R4 عندما يحتاج نظام آخر إلى قراءة البيانات، أو عندما تحتاج إلى بحث FHIR، _history، $everything أو $summary، أو عندما يطلب منك الاعتماد ذلك. كلاهما يرى نفس السجل.

كيف تتم معالجة موافقة المريض؟

يمنح الشخص التطبيق حق الوصول إلى سجله من خلال OAuth، ويختار النطاقات (scopes) ومدة (30، 90، 180 أو 365 يومًا). يمكن إلغاء المنحة في أي وقت، ويرى المريض كل قراءة في سجل الوصول. التفاصيل في نموذج الموافقة.

أين يتم استضافة البيانات؟

في الاتحاد الأوروبي (Cloud Run، europe-west4)، مع سجل المصدر وسجل الإصدارات عند كل كتابة. يتطلب الاستخدام الإنتاجي اتفاقية معالجة بيانات موقعة.

ما تكلفة الإنتاج؟

يبدأ الإنتاج من 49 يورو شهريًا لـ 2500 مريض مخزن، مع الشهر الأول مجانًا؛ الخطط الأكبر هي 199 يورو و 799 يورو شهريًا. تظل بيئة الاختبار مجانية. انظر التسعير.

هل يعمل مع وكلاء الذكاء الاصطناعي؟

نعم. هناك واجهة برمجة تطبيقات سياق الذكاء الاصطناعي مع تسميات المصدر وميزانية رمزية، وخادم MCP على platform.anpheros.com/mcp يمكن لأي مساعد قادر على MCP الاتصال به. انظر تكامل السجلات الطبية الإلكترونية مع مساعدي الذكاء الاصطناعي الطبيين.