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

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

Source: https://developers.anpheros.com/ar/guides/healthcare-api

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

<!-- visual: hapi-hero -->

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

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

<!-- visual: hapi-request -->

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

| النوع | ما يتم تبادله | الاستخدام النموذجي |
|---|---|---|
| واجهات برمجة تطبيقات 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 مباشرة.

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

<!-- visual:hapi-checklist:replace -->

- **نموذج بيانات قياسي**، بحيث يمكن نقل البيانات بين الأنظمة دون الحاجة إلى تعيين مخصص.
- **تفويض يتحكم فيه المريض**، وليس فقط بيانات اعتماد تتحكم فيها التطبيقات.
- **المصدر (Provenance)**: من كتب كل قيمة، وباسم من، ومن أي نظام.
- **السجل (History)**: إصدارات بدلاً من الكتابة فوق البيانات بصمت.
- **قابلية التدقيق (Auditability)** للقراءات، وليس فقط للكتابات.
- **إعادة المحاولة الآمنة (Safe retries)** (التطابقية - idempotency) و**الأخطاء المتوقعة (predictable errors)**، لأن بيانات الصحة يجب ألا تتكرر أو تُفقد.
- **العزل (Isolation)** بين التطبيقات التي تشترك في نفس البنية التحتية.
- **محلية البيانات (Data residency)** التي تتطابق مع مكان تواجد المرضى.

يعرض باقي هذه الصفحة كيف يظهر كل من هذه العناصر في واجهة برمجة تطبيقات 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_…`) لتطبيق يعمل نيابة عن مريض واحد بموجب موافقة.

```bash
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`.

```bash
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. [الأخطاء](https://developers.anpheros.com/ar/guides/errors) · [الحدود](https://developers.anpheros.com/ar/guides/limits)

### الأحداث

خطافات ويب موقعة لـ `resource.created`، `resource.updated`، `resource.deleted`، `consent.granted`، `consent.revoked`، `document.finalized` و `ping`. [خطافات الويب](https://developers.anpheros.com/ar/guides/webhooks)

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

استخدم **FHIR** عندما تعمل بالفعل مع FHIR، أو تحتاج إلى أنواع موارد لا يغطيها `/v1` (على سبيل المثال `Immunization`، `Procedure` أو `CarePlan`)، أو تقوم بتبادل البيانات مع أنظمة FHIR أخرى. استخدم **REST v1** لتعليمات برمجية للتطبيقات التي تريد JSON مسطحًا للحالات الشائعة. كلاهما يقرأ ويكتب نفس الموارد بنفس المعرفات، لذلك يمكن للمشروع مزجهما. يصف [Medical data API](https://developers.anpheros.com/ar/guides/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` (هولندا).

### أي واجهة برمجة تطبيقات رعاية صحية يجب أن أختار؟
قارن معيار البيانات، ومن يقوم بتفويض الوصول، والمصدر والتدقيق، ومكان إقامة البيانات، وكيفية سلوك إعادة المحاولة والأخطاء، وما إذا كان يمكنك الاختبار ببيانات واقعية مجانًا. [منصة واجهة برمجة تطبيقات الرعاية الصحية: ما تتضمنه وكيفية الاختيار](https://developers.anpheros.com/ar/guides/healthcare-api-platform) تحول هذه إلى أسئلة لطرحها على أي بائع.

<!-- visual:cta-hapi -->

## ذات الصلة

- [واجهة برمجة تطبيقات السجلات الصحية وواجهة برمجة تطبيقات السجلات الطبية](https://developers.anpheros.com/ar/guides/ehr-api)
- [منصة واجهات برمجة تطبيقات الرعاية الصحية: ما تتضمنه وكيفية الاختيار](https://developers.anpheros.com/ar/guides/healthcare-api-platform)
- [كيفية بناء واجهة برمجة تطبيقات للرعاية الصحية باستخدام TypeScript](https://developers.anpheros.com/ar/guides/healthcare-api-typescript): دليل تفصيلي مع Express
- [كيفية تخزين السجلات الطبية باستخدام FHIR R4](https://developers.anpheros.com/ar/guides/store-medical-records-fhir): دليل تفصيلي مع curl
- [واجهة برمجة تطبيقات الرعاية الصحية بموافقة المريض](https://developers.anpheros.com/ar/guides/healthcare-api-patient-consent)
- [الواجهة الخلفية لـ SMART on FHIR](https://developers.anpheros.com/ar/guides/smart-on-fhir-backend)
- [واجهة برمجة تطبيقات البيانات الطبية](https://developers.anpheros.com/ar/guides/medical-data-api)
- [منصة FHIR](https://developers.anpheros.com/ar/guides/fhir)
- [قابلية التشغيل البيني لبيانات الرعاية الصحية](https://developers.anpheros.com/ar/guides/interoperability)
- [تكاملات الرعاية الصحية](https://developers.anpheros.com/ar/guides/healthcare-integrations)
- [مرجع واجهة برمجة التطبيقات (OpenAPI)](https://developers.anpheros.com/docs) · [المصادقة و OAuth](https://developers.anpheros.com/ar/guides/authentication)