# البناء مع Anpheros

> المسار من الوصول إلى الإنتاج في تسع خطوات — المصادقة، واجهة برمجة التطبيقات (API)، البيانات الطبية، الموافقة، FHIR، خطافات الويب (webhooks)، مجموعات أدوات التطوير (SDKs)، والانطلاق — مع دليل لكل خطوة.

Source: https://developers.anpheros.com/ar/guides/build-with-anpheros

**البناء على Anpheros يعني استخدامه كطبقة البيانات الطبية لتطبيقك: يقوم منتجك باستدعاء واجهة برمجة التطبيقات (API) الخاصة بـ Anpheros لتخزين وقراءة سجلات المرضى بتنسيق HL7 FHIR R4، وللحصول على موافقة المريض، ولتلقي الأحداث.** هذه الصفحة هي الخريطة من الوصول الأولي إلى الإنتاج؛ كل خطوة ترتبط بالدليل الذي يغطيها بالتفصيل.

## 1. الحصول على الوصول

منصة Anpheros في مرحلة تجريبية خاصة. بيئة الاختبار المعزولة (sandbox) ذاتية الخدمة: قم بتسجيل الدخول باستخدام Google على لوحة التحكم (`https://platform.anpheros.com/dashboard/`) واضغط على *الحصول على مفتاح بيئة اختبار معزولة* — ستحصل على مؤسسة، ومشروع بيئة اختبار معزولة مع 30 مريضًا اصطناعيًا خاصًا به، ومفتاح. الوصول إلى بيئة الإنتاج يتم عن طريق الطلب (`contact@anpheros.com`). يمكنك إنشاء مشاريع إضافية ومفاتيح API في لوحة التحكم أو عبر Admin API؛ يتم تسجيل تطبيقات OAuth مع `POST /admin/projects/{id}/applications` والخطافات (webhooks) مع `POST /v1/webhooks`.

**المشروع** هو وحدة العزل: مفاتيحه ترى فقط المرضى الذين أنشأهم (وبموافقة، أولئك الذين منحوه الوصول).

## 2. المصادقة

| بيانات الاعتماد | لـ | تبدو كـ |
|---|---|---|
| مفتاح API | خوادمك | `sk_test_…` (بيئة تجريبية)، `sk_live_…` (بيئة إنتاجية) |
| رمز وصول OAuth | تطبيق يعمل نيابة عن مريض واحد | `at_…`، صالح لمدة 30 دقيقة، يتم تحديثه برمز تحديث دوار |

أرسلها كـ `Authorization: Bearer <credential>`. يتم عرض المفاتيح مرة واحدة ولا يجب أن تكون أبدًا في تطبيق جوال أو ويب. → [المصادقة و OAuth](https://developers.anpheros.com/ar/guides/authentication)

## 3. الاتصال بواجهة برمجة التطبيقات (API)

عنوان URL الأساسي `https://platform.anpheros.com`؛ REST في `/v1`، FHIR R4 في `/fhir/R4`. يصف الدليل التفاعلي ومواصفات OpenAPI كل نقطة نهاية.

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

→ [مرجع واجهة برمجة التطبيقات (API)](https://developers.anpheros.com/docs) · [واجهة برمجة تطبيقات الرعاية الصحية](https://developers.anpheros.com/ar/guides/healthcare-api)

## ٤. إنشاء وقراءة البيانات الطبية

أنشئ مريضًا لكل مستخدم من مستخدميك، واكتب الملاحظات، والحالات، والأدوية، والمستندات باستخدام `Idempotency-Key`، واقرأها مرة أخرى كقوائم أو جدول زمني. حدد مؤلف كل عملية كتابة (`patient`، `practitioner`، `device`، `import`، `ai`).

→ [البدء](https://developers.anpheros.com/ar/guides/getting-started) · [واجهة برمجة تطبيقات البيانات الطبية](https://developers.anpheros.com/ar/guides/medical-data-api) · [بناء تطبيق رعاية صحية](https://developers.anpheros.com/ar/guides/build-a-healthcare-app)

## 5. إضافة الموافقة

للوصول إلى سجل يحتفظ به شخص ما بالفعل في Anpheros، قم بتسجيل تطبيق OAuth مع عنوان URI الخاص بإعادة التوجيه الخاص به، وأرسل الشخص إلى صفحة الموافقة بالنطاقات التي تحتاجها، وقم بتبادل الرمز (PKCE) للحصول على الرموز. يختار الشخص المدة ويمكنه إلغاء الوصول في أي وقت؛ كل قراءة مرئية له.

→ [نموذج الموافقة والوصول](https://developers.anpheros.com/ar/guides/consent) · [المصادقة و OAuth](https://developers.anpheros.com/ar/guides/authentication)

## 6. استخدم FHIR عندما تحتاج إلى النموذج الكامل

أنواع الموارد بخلاف واجهة برمجة التطبيقات REST — التطعيمات، الإجراءات، خطط الرعاية، الحساسية، اللقاءات وغيرها، 26 إجمالاً — متاحة عبر FHIR R4، جنبًا إلى جنب مع البحث، السجل، المعاملات، `$everything` والملخص الدولي للمريض (`$summary`).

→ [منصة FHIR](https://developers.anpheros.com/ar/guides/fhir) · [أنظمة أكواد FHIR](https://developers.anpheros.com/ar/guides/fhir-code-systems) · [قابلية التشغيل البيني للبيانات الصحية](https://developers.anpheros.com/ar/guides/interoperability)

## 7. الاستجابة للأحداث

قم بتسجيل نقطة نهاية ويب هوك لأحداث `resource.*` أو `consent.*` أو `document.finalized` وتحقق من `Anpheros-Signature` لكل تسليم. يمكن إرسال تقارير المختبر في مكالمة واحدة إلى موصل المختبر.

→ [Webhooks](https://developers.anpheros.com/ar/guides/webhooks) · [Lab connector](https://developers.anpheros.com/guides/lab-connector) · [Healthcare integrations](https://developers.anpheros.com/ar/guides/healthcare-integrations)

## 8. استخدام حزمة تطوير البرامج (SDK)

`@anpheros/sdk` (TypeScript: Node 18+، المتصفحات، Deno، Bun) و `anpheros_sdk` (Dart / Flutter) تغطي واجهة برمجة التطبيقات العامة بالكامل بنفس الشكل، وتضيف مفاتيح التكرار إلى عمليات الإنشاء، وتعيد المحاولة عند `429`/`5xx`، وتحديث الرموز المميزة، وتنفذ تدفق الموافقة.

```bash
npm install @anpheros/sdk        # or: dart pub add anpheros_sdk
```

→ [حزم تطوير البرامج (SDKs)](https://developers.anpheros.com/ar/guides/sdks)

## 9. الانتقال إلى بيئة الإنتاج

- مفاتيح الإنتاج (`sk_live_`) تُصدر للمنظمات المعتمدة بعد توقيع اتفاقية معالجة بيانات.
- خطط لحدود النسخة التجريبية الخاصة: منطقة واحدة، لا يوجد اتفاق مستوى خدمة تعاقدي (SLA)، 600 طلب في الدقيقة لكل مفتاح ولكل عنوان IP.
- تعامل مع الأخطاء حسب النوع واحتفظ بـ `Anpheros-Request-Id` للدعم.
- راجع كيفية حماية البيانات وأين يتم تخزينها.

→ [الأمان والخصوصية ومكان البيانات](https://developers.anpheros.com/ar/guides/security) · [الحدود](https://developers.anpheros.com/ar/guides/limits) · [الأخطاء](https://developers.anpheros.com/ar/guides/errors) · [الإصدارات والإيقاف](https://developers.anpheros.com/ar/guides/versioning)

## إضافة الذكاء الاصطناعي

إذا كان منتجك يتضمن مساعدًا أو وكيلًا للذكاء الاصطناعي، فإن واجهة برمجة تطبيقات السياق (context API) تُعد الجزء ذا الصلة من السجل للنموذج الذي تستخدمه، ضمن ميزانية رموز (token budget) ومع تسمية كل عنصر حسب مصدره. → [تطبيقات الرعاية الصحية بالذكاء الاصطناعي](https://developers.anpheros.com/ar/guides/ai-healthcare)

## ذات صلة

- [Anpheros للمطورين](https://developers.anpheros.com/ar/guides/developers)
- [تطوير برمجيات الرعاية الصحية](https://developers.anpheros.com/ar/guides/healthcare-software)
- [شركات ناشئة في مجال الرعاية الصحية](https://developers.anpheros.com/ar/guides/healthcare-startups)