انتقل إلى المحتوى

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

حوّل مدخلات شاشة تقييم الحركة إلى درجة أهمية، وخرائط المناطق المقيدة، وتوجيهات التنفيذ التصحيحي.

نقطة النهاية

  • GET /api/v1/fitness/mobility-assessment
  • POST /api/v1/fitness/mobility-assessment/post

المعلمات

الاسم النوع مطلوب في الوصف
ankle_mobility_score رقم (0-100) نعم استعلام/جسم درجة حركة الكاحل.
hip_mobility_score رقم (0-100) نعم استعلام/جسم درجة حركة الورك.
shoulder_mobility_score رقم (0-100) نعم استعلام/جسم درجة حركة الكتف.
posture_type سلسلة نعم استعلام/جسم neutral,anterior_pelvic_tilt,kyphotic,lordotic,swayback,flat_back.
lang سلسلة لا استعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

لماذا تستخدم هذه نقطة النهاية

  • تحويل تقييمات الحركة إلى برامج تصحيحية منظمة.
  • تحديد المناطق الأكثر تقييدًا للحركة بسرعة.
  • إنشاء منطق تخصيص تدفئة للمنتجات التدريبية.

ابدأ الآن

مثال على الطلب

curl -X GET "https://api.hefitapi.com/api/v1/fitness/mobility-assessment?ankle_mobility_score=52&hip_mobility_score=61&shoulder_mobility_score=68&posture_type=anterior_pelvic_tilt&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/mobility-assessment/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"ankle_mobility_score":58,"hip_mobility_score":55,"shoulder_mobility_score":63,"posture_type":"kyphotic"}'

مثال على الاستجابة

معلومات

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

{
  "ankle_mobility_score": 52.0,
  "hip_mobility_score": 61.0,
  "shoulder_mobility_score": 68.0,
  "posture_type": "anterior_pelvic_tilt",
  "posture_type_label": "Anterior Pelvic Tilt",
  "composite_mobility_score": 60,
  "restriction_severity": {
    "score": 47,
    "level": "moderate",
    "level_label": "Moderate",
    "insight": "Mobility deficits may limit movement quality under load."
  },
  "limiting_regions": [
    {"region": "ankle", "region_label": "Ankle", "score": 52.0, "restriction_level": "moderate"},
    {"region": "hip", "region_label": "Hip", "score": 61.0, "restriction_level": "moderate"},
    {"region": "shoulder", "region_label": "Shoulder", "score": 68.0, "restriction_level": "low"}
  ],
  "corrective_focus": ["Restore ankle and hip mobility through daily drills"],
  "warmup_customization_advice": ["Add mobility prep before loaded sessions"],
  "retest_window_days": 21,
  "confidence_score": 76,
  "summary": "Moderate restriction profile with targeted corrective opportunity.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "71d65d488d78d9b4", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_mobility_assessment", "response_language": "en"}
}

تحديد المنتج

نقطة نهاية أساسية عملية لتطبيقات فحص الحركة وعمليات SaaS التدريبية.

ملاحظة

يجب أن تكون جميع درجات الحركة 0-100؛ القيم غير الصالحة ترجع HTTP 400.

نقاط النهاية الموصى بها