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

> قم بتخزين الخطوات، ومعدل ضربات القلب، وتقلب معدل ضربات القلب، والنوم، وتشبع الأكسجين (SpO₂) من أي جهاز قابل للارتداء كـ FHIR Observations مرمزة بـ LOINC: الأجهزة التي تصل إلى أي متجر صحي، ولماذا لا توجد واجهة برمجة تطبيقات ويب، والطلبات العاملة.

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

تسمح واجهة برمجة تطبيقات تعقب الصحة للتطبيق بإرسال وقراءة البيانات التي تجمعها الساعات، والخواتم، والأساور، والموازين — الخطوات، ومعدل ضربات القلب، وتقلب معدل ضربات القلب، والنوم، وتشبع الأكسجين، والوزن — كبيانات منظمة على خادم. معظم الأجهزة لا تقدم واجهة برمجة تطبيقات مشتركة واحدة: تصل بياناتها إلى متجر الصحة الخاص بالهاتف (Apple HealthKit أو Android Health Connect)، ويقرأها تطبيقك من هناك. Anpheros هو الجانب الخادم: يكتب تطبيقك القراءات كـ FHIR R4 Observations مرمزة بـ LOINC، ويقرأ كل تطبيق آخر أو عيادة أو وكيل ذكاء اصطناعي بنفس البيانات من خلال واجهة برمجة تطبيقات واحدة بموافقة الشخص.

<!-- visual:tracker-flow -->

## الأجهزة التي تصل إلى أي مخزن صحي

| الجهاز | يصل إلى | اقرأه باستخدام |
|---|---|---|
| Apple Watch، iPhone، العديد من تطبيقات iOS | Apple HealthKit | Swift على iPhone ([Apple Health إلى FHIR](https://developers.anpheros.com/ar/guides/apple-health-fhir)) |
| Galaxy Watch، Wear OS، Fitbit، Garmin، Oura، Withings (تطبيقات Android) | Android Health Connect | Kotlin أو Flutter على الهاتف ([Health Connect إلى FHIR](https://developers.anpheros.com/ar/guides/health-connect-fhir)) |
| تفاصيل Galaxy Watch غير موجودة في Health Connect | Samsung Health | Samsung Health Data SDK ([Samsung Health إلى FHIR](https://developers.anpheros.com/ar/guides/samsung-health-fhir)) |

لا يمتلك HealthKit ولا Health Connect واجهة برمجة تطبيقات ويب أو REST: البيانات موجودة على الهاتف، ولا يمكن قراءتها إلا بواسطة تطبيق قام الشخص بتثبيته والسماح له بذلك. لذلك، تبدأ واجهة برمجة تطبيقات متتبع الصحة على خادم دائمًا بتطبيق جوال صغير.

<!-- visual:tracker-codes -->

## كتابة يوم واحد من الخطوات

```bash
curl -X POST https://platform.anpheros.com/fhir/R4/Observation \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/fhir+json" \
  -H "Idempotency-Key: steps-$PID-2026-10-15" \
  -d '{
    "resourceType": "Observation",
    "status": "final",
    "category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "activity"}]}],
    "code": {"coding": [{"system": "http://loinc.org", "code": "41950-7", "display": "Number of steps in 24 hour Measured"}]},
    "subject": {"reference": "Patient/'"$PID"'"},
    "effectivePeriod": {"start": "2026-10-15T00:00:00+03:00", "end": "2026-10-16T00:00:00+03:00"},
    "valueQuantity": {"value": 8412, "unit": "steps", "system": "http://unitsofmeasure.org", "code": "{steps}"}
  }'
```

قم بتخزين ملاحظة (Observation) واحدة لكل مقياس في كل يوم محلي، مع تحديد المنطقة الزمنية للشخص في الفترة. الـ `Idempotency-Key` يجعل إعادة الإرسال غير ضارة. [بيانات الأجهزة القابلة للارتداء في FHIR](https://developers.anpheros.com/ar/guides/wearable-data-fhir) تحتوي على جدول LOINC الكامل وعملية تحديث يومية تم اختبارها.

## قراءتها مرة أخرى

```bash
# the last 30 daily step counts
curl "https://platform.anpheros.com/fhir/R4/Observation?patient=$PID&code=http://loinc.org|41950-7&_sort=-date&_count=30" \
  -H "Authorization: Bearer $KEY"
```

تطبيق آخر يقرأ نفس البيانات فقط بموافقة الشخص (OAuth 2.1، نطاقات SMART مثل `patient/Observation.rs?category=activity`)، ويتم تسجيل كل قراءة حيث يمكن للشخص رؤيتها.

## أسئلة متكررة

### هل توجد واجهة برمجة تطبيقات مجانية لتتبع الصحة؟
لدى Anpheros بيئة اختبار مجانية (sandbox): قم بتخزين وقراءة بيانات المتتبع كـ FHIR Observations مع 30 مريضًا اصطناعيًا. واجهات برمجة التطبيقات الخاصة بمصنعي الأجهزة (Fitbit, Garmin, Oura, Withings) لها قواعد وشروط وصول خاصة بها.

### هل توجد واجهة برمجة تطبيقات ويب لـ Apple Health أو Health Connect؟
لا. تحتفظ HealthKit و Health Connect بالبيانات على الهاتف؛ يقوم التطبيق المثبت بقراءتها بإذن الشخص ويمكنه إرسالها إلى خادم مثل Anpheros.

### ما هي الرموز التي يجب أن تستخدمها واجهة برمجة تطبيقات تتبع الصحة؟
LOINC: 41950-7 خطوات، 8867-4 معدل ضربات القلب، 40443-4 معدل ضربات القلب أثناء الراحة، 80404-7 تباين معدل ضربات القلب (RMSSD)، 59408-5 تشبع الأكسجين، 93832-4 مدة النوم، 29463-7 وزن الجسم. الوحدات في UCUM.

### هل يتصل Anpheros بـ Fitbit أو Garmin مباشرة؟
لا. تصل بياناتهم إلى Anpheros عبر مخزن الصحة الخاص بالهاتف وتطبيقك؛ لا يوجد اتصال مباشر من سحابة إلى سحابة.

<!-- visual:cta-tracker -->

## ذات الصلة

- [واجهات برمجة تطبيقات الأجهزة القابلة للارتداء: Fitbit، Garmin، Oura، و Withings](https://developers.anpheros.com/ar/guides/wearable-apis)
- [إيقاف تشغيل واجهة برمجة تطبيقات Fitbit Web (أكتوبر 2026)](https://developers.anpheros.com/ar/guides/fitbit-web-api-shutdown)
- [بيانات الأجهزة القابلة للارتداء في FHIR (Apple Health، Health Connect)](https://developers.anpheros.com/ar/guides/wearable-data-fhir)
- [مراقبة المرضى عن بعد باستخدام FHIR](https://developers.anpheros.com/ar/guides/remote-patient-monitoring-fhir)
- [تطبيق السجل الصحي الشخصي (PHR) باستخدام FHIR](https://developers.anpheros.com/ar/guides/personal-health-record-app)
- [واجهة برمجة تطبيقات البيانات الطبية](https://developers.anpheros.com/ar/guides/medical-data-api)