# واجهة برمجة تطبيقات البيانات الطبية

> أين يذهب كل نوع من أنواع البيانات الطبية في واجهة برمجة تطبيقات Anpheros، وكيف يتم ترميزها، وكيفية كتابتها وتصفيتها وتتبعها وتصحيحها وحذفها — مع أمثلة عملية.

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

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

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

للحصول على الصورة الأوسع (المصادقة، الموافقة، الأحداث) انظر [واجهة برمجة تطبيقات الرعاية الصحية](https://developers.anpheros.com/ar/guides/healthcare-api).

## أين يذهب كل نوع من أنواع البيانات الطبية

| البيانات الطبية | REST v1 | مورد FHIR | الترميز |
|---|---|---|---|
| الشخص | `POST /v1/patients` | `Patient` | الاسم، تاريخ الميلاد، الجنس، المعرفات |
| العلامات الحيوية، نتائج المختبر، الأعراض، النشاط، الاستبيانات | `/v1/patients/{id}/observations` | `Observation` | LOINC (الأعراض: فصل ICD-10 R)؛ وحدات UCUM |
| التشخيصات والمشاكل | `/v1/patients/{id}/conditions` | `Condition` | ICD-10 |
| الأدوية | `/v1/patients/{id}/medications` | `MedicationStatement` | ATC، اسم المنتج يبقى كنص |
| المستندات (PDF، صور) | `/v1/patients/{id}/documents` | `DocumentReference` | أنواع مستندات LOINC |
| تقرير مختبر كامل | `POST /v1/patients/{id}/labs/import` | `Observation` (مختبر) | LOINC حيثما كان معروفًا، رمز المختبر الخاص به بخلاف ذلك |
| الجرعات التي تم تناولها أو تخطيها، التطعيمات، الحساسية، الإجراءات، التقارير، خطط الرعاية، الأهداف، الإحالات، الزيارات، المواعيد، فرق الرعاية، التاريخ العائلي، الاستبيانات | `/fhir/R4/{type}` | `MedicationAdministration`، `Immunization`، `AllergyIntolerance`، `Procedure`، `DiagnosticReport`، `CarePlan`، `Goal`، `ServiceRequest`، `Encounter`، `Appointment`، `CareTeam`، `FamilyMemberHistory`، `QuestionnaireResponse` | لكل [أنظمة ترميز FHIR](https://developers.anpheros.com/ar/guides/fhir-code-systems) |

كائنات REST v1 وموارد FHIR هي نفس السجلات بنفس المعرفات؛ كل كائن v1 يحمل مرجع `fhir` الخاص به.

## كتابة البيانات الطبية

```bash
# a lab result with its reference range, linked to the report it came from
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": "4548-4", "display": "Hemoglobin A1c", "category": "laboratory",
  "value": 6.4, "unit": "%", "effective_at": "2026-09-01T08:00:00Z",
  "reference_range": {"low": 4.0, "high": 5.6},
  "derived_from": ["DocumentReference/'$DOC'"], "author_type": "import"
}'
```

- **فئات الملاحظات:** `vital-signs`، `laboratory`، `symptom`، `activity`، `survey`، `exam`، `imaging`، `social-history`.
- **القياسات المركبة** مثل ضغط الدم تستخدم `components` (الانقباضي `8480-6`، الانبساطي `8462-4` داخل اللوحة `85354-9`).
- **أنواع المؤلفين:** `patient`، `practitioner`، `device`، `import`، `ai`. بدون أحدها، يسجل النظام `import`.
- **الرموز التي لا تعرفها عن ظهر قلب:** `GET /v1/terminology/loinc?q=hba1c` يبحث في مجموعة LOINC المجمعة و `GET /v1/search?q=metformin` في كتالوج الأعراض والحالات والأدوية؛ الملاحظة المكتوبة بدون اسم عرض تحصل على اسم LOINC تلقائيًا.

## قراءة البيانات الطبية

```bash
curl "https://platform.anpheros.com/v1/patients/$PID/observations?category=laboratory&code=4548-4&from=2026-01-01" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/conditions?clinical_status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"
```

| نقطة النهاية (Endpoint) | المرشحات (Filters) |
|---|---|
| observations | `category`, `code`, `from`, `to` |
| conditions | `clinical_status` |
| medications | `status` |
| documents | `kind` |
| timeline | `from`, `to`, `types` |

يتم ترقيم القوائم باستخدام `limit` و `cursor`. تقوم نقطة النهاية **timeline** بدمج الملاحظات (observations)، والحالات (conditions)، والأدوية (medications)، والمستندات (documents)، والزيارات (visits)، والمواعيد (appointments)، والتطعيمات (vaccinations)، وحلقات الرعاية (episodes of care) في قائمة زمنية واحدة — وهي المدخل الطبيعي لشاشة سجل المريض.

لأي شيء لا تغطيه مرشحات REST، استخدم بحث FHIR: `GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date` ([منصة FHIR](https://developers.anpheros.com/ar/guides/fhir)).

## تتبع البيانات وتصحيحها

- **من كتبها:** `GET /v1/patients/{id}/provenance/{type}/{resourceId}` — إدخال واحد لكل إصدار، مع نوع المؤلف والمشروع والمؤسسة ونظام المصدر.
- **كل إصدار:** `GET /fhir/R4/{type}/{id}/_history`؛ قم بالتحديث باستخدام `If-Match` لتجنب الكتابة فوق تغيير شخص آخر.
- **الملكية:** بموافقتك، يمكنك قراءة ما كتبته المنظمات الأخرى، ولكن قم بتغيير أو حذف ما كتبه مشروعك فقط (`403` بخلاف ذلك).
- **الحذف:** `DELETE /v1/{observations|conditions|medications}/{id}`؛ يؤدي حذف `Patient` إلى حذف السجل بأكمله.

## المستندات

قم بإنشاء المستند (ستحصل على هدف تحميل)، قم بتحميل البايتات عبر المنصة أو مباشرة إلى التخزين، ثم قم بالإنهاء. بعد الإنهاء، يصبح الأصل غير قابل للتغيير؛ يتم تسجيل قيمة SHA-256 وحجمه. بحد أقصى 25 ميجابايت لكل ملف.

## ذات الصلة

- [كيفية تسوية البيانات الطبية](https://developers.anpheros.com/ar/guides/normalize-medical-data): الرموز، الوحدات، التواريخ، التكرارات، التحقق من الصحة
- [شرح مصدر البيانات الطبية](https://developers.anpheros.com/ar/guides/medical-data-provenance): من كتب ماذا، وكيفية تسجيله
- [واجهة برمجة تطبيقات الرعاية الصحية](https://developers.anpheros.com/ar/guides/healthcare-api)
- [السجل الطبي للمريض](https://developers.anpheros.com/ar/guides/patient-medical-record)
- [بناء تطبيق للرعاية الصحية](https://developers.anpheros.com/ar/guides/build-a-healthcare-app)
- [مرجع واجهة برمجة التطبيقات (OpenAPI)](https://developers.anpheros.com/docs) · [البدء](https://developers.anpheros.com/ar/guides/getting-started)