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

واجهة برمجة تطبيقات مؤشر التعب المركزي

إرجاع درجة التعب العصبي، وحالة التعافي العصبي، وتوصيات بشأن التحفيز الثقيل/الخفيف/الراحة مع إرشادات استرجاع قابلة للتنفيذ.

نقطة النهاية

  • GET /api/v1/fitness/central-fatigue-index
  • POST /api/v1/fitness/central-fatigue-index/post

المعلمات

الاسم النوع مطلوب في الوصف
sleep_hours رقم (0-16) نعم استعلام/جسم مدة النوم الليلة الماضية.
resting_hr رقم (30-120) نعم استعلام/جسم معدل ضربات القلب أثناء الراحة (نبضة في الدقيقة).
hrv رقم (10-200) نعم استعلام/جسم معدل النبض الخارجي (بالمللي ثانية).
motivation_level عدد صحيح (1-10) نعم استعلام/جسم الدافع/الاستعداد الذاتي.
reaction_time_ms رقم (120-800) لا استعلام/جسم إشارة وقت الاستجابة الاختيارية.
lang سلسلة لا استعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

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

  • دمج علم الاستعداد في البرمجة اليومية.
  • منع الإفراط في التدريب بسبب تراكم التعب العصبي.
  • تشغيل محركات توصية قابلة للتفسير للتحفيز الثقيل/الخفيف/الراحة.

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/fitness/central-fatigue-index?sleep_hours=6.4&resting_hr=68&hrv=46&motivation_level=5&reaction_time_ms=305&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/central-fatigue-index/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sleep_hours":6.4,"resting_hr":68,"hrv":46,"motivation_level":5,"reaction_time_ms":305}'

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

معلومات

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

{
  "cns_fatigue_score": 58,
  "neural_recovery_status": {
    "status": "fatigued",
    "status_label": "Fatigued",
    "insight": "Recovery is incomplete; reduce neural load today."
  },
  "stimulus_recommendation": {
    "target": "light",
    "target_label": "Light",
    "session_note": "Favor technique and quality over max output."
  },
  "fatigue_component_load": {
    "sleep_load": 12.8,
    "autonomic_load": 28.1,
    "motivation_load": 8.0,
    "reaction_load": 4.4
  },
  "inputs": {
    "sleep_hours": 6.4,
    "resting_hr_bpm": 68.0,
    "hrv_ms": 46.0,
    "motivation_level": 5,
    "reaction_time_ms": 305.0
  },
  "recovery_recommendations": ["Reduce CNS load", "Prioritize sleep quality"],
  "next_review_window_hours": 18,
  "summary": "Central fatigue is elevated and should be managed.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "0ab43e1d95ca77df",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "fitness_central_fatigue_index",
    "response_language": "en"
  }
}

الموقف التجاري

ميزة متميزة لمراقبة الرياضيين، وذكاء اصطناعي للتعافي، ومنصات التدريب المؤسسية.

ملاحظة

reaction_time_ms اختياري؛ جميع مدخلات الاستعداد الأخرى مطلوبة.

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