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

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

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

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

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

للحصول على الصورة الأوسع (المصادقة، الموافقة، الأحداث) انظر واجهة برمجة تطبيقات الرعاية الصحية.

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

البيانات الطبية	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

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

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

# 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 تلقائيًا.

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

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).

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

من كتبها: 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 ميجابايت لكل ملف.

ذات الصلة

كيفية تسوية البيانات الطبية: الرموز، الوحدات، التواريخ، التكرارات، التحقق من الصحة
شرح مصدر البيانات الطبية: من كتب ماذا، وكيفية تسجيله
واجهة برمجة تطبيقات الرعاية الصحية
السجل الطبي للمريض
بناء تطبيق للرعاية الصحية
مرجع واجهة برمجة التطبيقات (OpenAPI) · البدء

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