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

واجهة برمجة تطبيقات الرعاية الصحية: ما هي وكيف تعمل

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

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

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

بغض النظر عن البائع، تمر استدعاءات واجهة برمجة تطبيقات الرعاية الصحية بنفس نقاط الفحص: من يتصل، وأي مريض والبيانات التي قد يمسها، وأين يتم تخزين البيانات، ومن كتبها، ومن يحتاج إلى معرفة أنها تغيرت.

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

النوع	ما يتم تبادله	الاستخدام النموذجي
واجهات برمجة تطبيقات FHIR REST	موارد FHIR عبر HTTP (`GET /Observation?patient=…`)	المعيار الحديث لتبادل البيانات السريرية
SMART on FHIR / OAuth	التفويض لواجهات برمجة تطبيقات FHIR	السماح لتطبيقات الطرف الثالث بالوصول إلى سجل بإذن المستخدم
رسائل HL7 v2	رسائل مفصولة بأنابيب (`ORU^R01` للنتائج، `ADT` للقبول)	أنظمة المختبرات والمستشفيات، غالبًا عبر الواجهات بدلاً من HTTP
تبادل المستندات	المستندات السريرية (PDF، CDA، حزم مستندات FHIR)	الملخصات، خطابات الخروج، الإحالات
واجهات برمجة تطبيقات REST الخاصة بالبائع	JSON خاص بالبائع	تطبيق الهاتف المحمول الخاص بمنتج واحد أو عمليات التكامل

تجمع Anpheros بين أول نوعين كنواة لها، وتقبل نتائج مختبر HL7 v2 كمدخلات، وتخزن المستندات مع أصولها، وتنتج حزم مستندات FHIR (ملخص المريض الدولي). كما أنها توفر واجهة برمجة تطبيقات REST أبسط عبر نفس البيانات للمطورين الذين لا يرغبون في العمل مع FHIR مباشرة.

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

What to look for in a healthcare API — and how Anpheros answers

Standard data modelHL7 FHIR R4 with LOINC, ICD-10, ATC, UCUM

Patient-controlled accessOAuth 2.1 consent with scopes, expiry and revocation

ProvenanceAuthor, organisation and source on every write

HistoryEvery version kept; conditional updates with If-Match

Audit of readsEach read and write logged, visible to the patient

Safe retriesIdempotency-Key on POST; predictable errors

IsolationPairwise patient ids per application

Data residencyEuropean Union: Google Cloud europe-west4

يعرض باقي هذه الصفحة كيف يظهر كل من هذه العناصر في واجهة برمجة تطبيقات Anpheros.

نظرة عامة على واجهة برمجة تطبيقات Anpheros

السطح	المسار الأساسي	الغرض
FHIR R4	`/fhir/R4`	26 أنواع موارد؛ قراءة، بحث، إنشاء، تحديث، حذف، سجل، معاملات، `$everything`، `$summary`، `$validate`
REST v1	`/v1`	المرضى، الملاحظات، الحالات، الأدوية، المستندات، الجدول الزمني، المصدر، سياق الذكاء الاصطناعي، استيراد المختبر، المصطلحات، خطافات الويب
OAuth 2.1	`/oauth`	صفحة الموافقة، الرموز (PKCE)، الإلغاء، مفاتيح OpenID Connect
جانب المريض	`/me`	سجلات الشخص نفسه، من لديه حق الوصول، سجل الوصول، إلغاء
الاكتشاف	`/fhir/R4/metadata`، `/fhir/R4/.well-known/smart-configuration`، `/openapi.json`	أوصاف واجهة برمجة التطبيقات قابلة للقراءة آليًا

عنوان URL الأساسي: https://platform.anpheros.com. تشترك بيئة الاختبار والإنتاج فيه؛ المفتاح يحدد مستوى البيانات.

المصادقة

مفاتيح واجهة برمجة التطبيقات (sk_test_…، sk_live_…) للخوادم الخاصة بك؛ ترى المرضى الذين أنشأهم مشروعك.
رموز وصول OAuth (at_…) لتطبيق يعمل نيابة عن مريض واحد بموجب موافقة.

curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"

الكتابة بأمان

طلبات POST تقبل Idempotency-Key: طلب مُعاد إجراؤه بنفس المفتاح يعيد الاستجابة الأصلية ولا ينشئ شيئًا. كل عملية كتابة تحصل على Provenance؛ يتم إرسال نوع المؤلف في الجسم (author_type) أو في رؤوس مثل X-Anpheros-Author-Type، X-Anpheros-Source-System، X-Anpheros-Origin-Id و X-Anpheros-On-Behalf-Of.

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": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'

الأخطاء والحدود

تنتهي نقاط نهاية FHIR بالرد بـ OperationOutcome؛ والآخرون بـ {"error": {"type", "message", "field"}}. كل استجابة تحمل Anpheros-Request-Id. الحد الافتراضي هو 600 طلب في الدقيقة لكل مفتاح ولكل عنوان IP. الأخطاء · الحدود

الأحداث

خطافات ويب موقعة لـ resource.created، resource.updated، resource.deleted، consent.granted، consent.revoked، document.finalized و ping. خطافات الويب

الاختيار بين FHIR و REST v1

استخدم FHIR عندما تعمل بالفعل مع FHIR، أو تحتاج إلى أنواع موارد لا يغطيها /v1 (على سبيل المثال Immunization، Procedure أو CarePlan)، أو تقوم بتبادل البيانات مع أنظمة FHIR أخرى. استخدم REST v1 لتعليمات برمجية للتطبيقات التي تريد JSON مسطحًا للحالات الشائعة. كلاهما يقرأ ويكتب نفس الموارد بنفس المعرفات، لذلك يمكن للمشروع مزجهما. يصف Medical data API عمليات البيانات بالتفصيل.

أسئلة متكررة

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

واجهة برمجية تقرأ بها البرامج وتكتب بيانات الرعاية الصحية — سجلات المرضى، والملاحظات، والتشخيصات، والأدوية، والمستندات — والتي يتم من خلالها تفويض الوصول إلى تلك البيانات. تستخدم واجهات برمجة تطبيقات الرعاية الصحية الحديثة HL7 FHIR R4 للبيانات و OAuth 2.0 أو 2.1 مع SMART on FHIR للتفويض.

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

FHIR هو معيار واحد يمكن لواجهة برمجة تطبيقات الرعاية الصحية اتباعه. تقوم واجهة برمجة تطبيقات FHIR بتبادل موارد FHIR عبر REST؛ قد تقبل واجهة برمجة تطبيقات الرعاية الصحية أيضًا رسائل HL7 v2 أو مستندات أو JSON مملوكة. تقدم Anpheros واجهة برمجة تطبيقات FHIR R4 وواجهة برمجة تطبيقات REST أبسط فوق نفس البيانات.

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

نعم. بيئة Anpheros التجريبية مجانية وذاتية الخدمة: قم بتسجيل الدخول باستخدام Google، واحصل على مفتاح API، واعمل مع 30 مريضًا اصطناعيًا عبر FHIR R4 أو REST. يبدأ الإنتاج من 49 يورو شهريًا، مع الشهر الأول مجانًا.

كيف يمنح المرضى الموافقة لواجهة برمجة تطبيقات الرعاية الصحية؟

من خلال OAuth 2.1 مع PKCE: يرسل التطبيق الشخص إلى صفحة موافقة مع نطاقات SMART on FHIR؛ يختار الشخص ما يريد مشاركته ولمدة، ويمكنه رؤية سجل الوصول، ويمكنه إلغاء الوصول في أي وقت.

أين يتم تخزين البيانات؟

في الاتحاد الأوروبي: تعمل الخدمة وقواعد بياناتها في Google Cloud europe-west4 (هولندا).

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

قارن معيار البيانات، ومن يقوم بتفويض الوصول، والمصدر والتدقيق، ومكان إقامة البيانات، وكيفية سلوك إعادة المحاولة والأخطاء، وما إذا كان يمكنك الاختبار ببيانات واقعية مجانًا. منصة واجهة برمجة تطبيقات الرعاية الصحية: ما تتضمنه وكيفية الاختيار تحول هذه إلى أسئلة لطرحها على أي بائع.

ذات الصلة

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