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

بناء تطبيق رعاية صحية

دليل تعليمي: استخدم Anpheros كواجهة خلفية للبيانات الطبية لتطبيق رعاية صحية — المرضى، القياسات، الحالات، الأدوية، المستندات، المختبرات، الموافقة، خطافات الويب، ومجموعات أدوات التطوير (SDKs).

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

ما الذي تقوم ببنائه

يحتاج تطبيق نموذجي للمريض — مثل متتبع للحالات المزمنة، أو تطبيق للصحة العائلية، أو رفيق للمراقبة عن بعد — إلى القيام بما يلي:

1. الاحتفاظ بسجل لكل مريض: القياسات، الحالات، الأدوية، المستندات؛
2. عرض هذا السجل مرة أخرى كقوائم وجدول زمني؛
3. قبول البيانات من مصادر أخرى (أجهزة، مختبرات، عيادات)؛
4. مشاركة أجزاء من السجل، بموافقة المريض؛
5. التفاعل عند حدوث تغيير.

مع Anpheros، يحتفظ تطبيقك بمستخدميه وشاشاته ومنطقه التجاري الخاص، ويفوض السجل الطبي إلى المنصة:

Mobile / web app ──► your backend ──► Anpheros Platform API ──► FHIR R4 record of each patient
                         ▲                                              │
                         └──────────── signed webhooks ◄────────────────┘

يحتفظ الواجهة الخلفية (backend) الخاص بك بمفتاح API؛ ويتحدث التطبيق مع الواجهة الخلفية الخاصة بك. (التطبيقات التي تعمل نيابة عن مريض لديه بالفعل سجل Anpheros تستخدم OAuth بدلاً من ذلك — انظر الخطوة 7.)

1. الحصول على مفتاح بيئة الاختبار

بيئة الاختبار ذاتية الخدمة: قم بتسجيل الدخول باستخدام Google على لوحة التحكم (https://platform.anpheros.com/dashboard/) واضغط على الحصول على مفتاح بيئة الاختبار. تبدأ مفاتيح بيئة الاختبار بـ sk_test_ ولا يمكنها الوصول إلا إلى قاعدة بيانات بيئة الاختبار، حيث يمتلك مشروعك بالفعل نسخته الخاصة من 30 مريضًا اصطناعيًا.

export BASE=https://platform.anpheros.com
export KEY=sk_test_…
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

2. إنشاء مريض

يحصل كل مستخدم لتطبيقك على سجل مريض مملوك لمشروعك.

curl -X POST $BASE/v1/patients -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -H "Idempotency-Key: $(uuidgen)" \
     -d '{"given": "Elena", "family": "Ionescu", "birth_date": "1985-09-03", "gender": "female"}'

يحتوي الرد على المريض id (معرفك الخاص لهذا الشخص - ترى المشاريع الأخرى معرفًا مختلفًا) ومرجع fhir الخاص به.

3. كتابة القياسات والحالات والأدوية

حدد مصدر البيانات باستخدام author_type: patient، practitioner، device، import أو ai. إذا حذفتها، يسجل النظام import، ولا يسجل أبدًا patient بالافتراض.

# a blood-pressure reading from a connected device (LOINC panel with two components)
curl -X POST $BASE/v1/patients/$PID/observations -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -H "Idempotency-Key: $(uuidgen)" -d '{
  "code": "85354-9", "display": "Blood pressure panel", "category": "vital-signs",
  "effective_at": "2026-09-28T08:00:00Z", "author_type": "device",
  "components": [
    {"code": "8480-6", "display": "Systolic", "value": 128, "unit": "mm[Hg]"},
    {"code": "8462-4", "display": "Diastolic", "value": 82, "unit": "mm[Hg]"}
  ]}'

# a diagnosis (ICD-10 by default)
curl -X POST $BASE/v1/patients/$PID/conditions -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"code": "I10", "display": "Essential hypertension", "onset": "2024-03-01", "author_type": "practitioner"}'

# a medication (ATC by default)
curl -X POST $BASE/v1/patients/$PID/medications -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"display": "Amlodipine 5 mg", "code": "C08CA01", "dosage": "1 tablet in the morning", "start": "2024-03-01", "author_type": "patient"}'

فئات الملاحظات: vital-signs، laboratory، symptom، activity، survey، exam، imaging، social-history. يتم تخزين كل عملية كتابة كمورد FHIR وتحصل على إدخال Provenance تلقائيًا.

4. تخزين المستندات

# create the document, then upload the bytes
curl -X POST $BASE/v1/patients/$PID/documents -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"title": "Blood tests 2026-09-14", "kind": "lab_report", "content_type": "application/pdf", "date": "2026-09-14"}'
curl -X PUT $BASE/v1/documents/$DOC/content -H "Authorization: Bearer $KEY" -H 'content-type: application/pdf' --data-binary @report.pdf

الأصل غير قابل للتغيير بعد التحميل؛ يمكن للقيم التي تستخرجها منه أن تشير إليه باستخدام derived_from.

5. قراءة السجل مرة أخرى

curl "$BASE/v1/patients/$PID/observations?category=vital-signs&limit=20" -H "Authorization: Bearer $KEY"
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"   # everything, chronologically

عندما تحتاج إلى نموذج FHIR الكامل، فإن نفس البيانات متاحة في /fhir/R4 بنفس المعرفات (FHIR R4 API).

6. ربط المختبرات والأجهزة

• تقارير المختبر: POST /v1/patients/{id}/labs/import مع CSV، أو HL7 v2 ORU^R01، أو JSON تحول التقرير بأكمله إلى ملاحظات مخبرية (Observations) مع رموز LOINC (موصل المختبر).
• الأجهزة والأجهزة القابلة للارتداء: كتابة ملاحظات (Observations) مع author_type: device ورمز LOINC للقياس (معدل ضربات القلب، SpO₂، الخطوات، مدة النوم وغيرها مدرجة في أنظمة رموز FHIR).

7. الوصول إلى سجل موجود لدى المريض (OAuth)

إذا كان لدى الشخص سجل بالفعل في Anpheros (على سبيل المثال، من خلال Anpheros Daily)، يمكن لتطبيقك طلب الوصول بدلاً من إنشاء مريض جديد: قم بتسجيل تطبيق، وأرسل الشخص إلى صفحة الموافقة مع النطاقات (scopes) التي تحتاجها، واستبدل الرمز (code) بالرموز المميزة (tokens)، ثم قم باستدعاء الـ API باستخدام الرمز المميز للوصول (access token). يختار المريض مدة الصلاحية ويمكنه إلغاء الوصول في أي وقت. التفاصيل: المصادقة و OAuth.

8. الاستجابة للتغييرات باستخدام خطافات الويب (Webhooks)

curl -X POST $BASE/v1/webhooks -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"url": "https://your.app/anpheros/hook", "events": ["resource.created", "consent.revoked"]}'

تحقق من ترويسة Anpheros-Signature لكل تسليم (خطافات الويب).

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

نفس التدفق في TypeScript:

import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });
const { data: patients } = await anpheros.patients.list();
const vitals = await anpheros.observations.list(patients[0].id, { category: 'vital-signs', limit: 20 });

يتوفر عميل Dart / Flutter بنفس الشكل باسم anpheros_sdk (SDKs).

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

• يتم إصدار مفاتيح الإنتاج (sk_live_) للمؤسسات المعتمدة بعد توقيع اتفاقية معالجة بيانات.
• اقرأ صفحة الأمان والخصوصية ومكان إقامة البيانات و الحدود.
• تعامل مع الأخطاء حسب نوعها واذكر ترويسة Anpheros-Request-Id عند التواصل مع الدعم (الأخطاء).

ذات الصلة

• كيفية بناء واجهة برمجة تطبيقات للرعاية الصحية باستخدام TypeScript: دليل تفصيلي خطوة بخطوة مع Express
• كيفية بناء تطبيق للرعاية الصحية باستخدام Flutter: دليل تفصيلي خطوة بخطوة مع Dart SDK
• كيفية بناء تطبيق ذكاء اصطناعي للرعاية الصحية مع واجهة خلفية FHIR: دليل تفصيلي خطوة بخطوة باستخدام TypeScript
• البناء مع Anpheros
• واجهة خلفية وقاعدة بيانات للتطبيقات الطبية
• واجهة برمجة تطبيقات البيانات الطبية
• تطوير برمجيات الرعاية الصحية
• كيفية بناء تطبيق سجل صحي شخصي (PHR) باستخدام FHIR

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