واجهة برمجة تطبيقات التدريب التكيفي¶
إرجاع قرار تدريب مدرك للجاهزية (push, maintain, pull_back) مع تفاوت في الشدة، وتعديل الحجم، ونقل الإصابات، ودرجة الثقة.
نقطة النهاية¶
-
GET /api/v1/fitness/adaptive-training-load -
POST /api/v1/fitness/adaptive-training-load/post
المعلمات¶
| الاسم | النوع | مطلوب | في | الوصف |
|---|---|---|---|---|
planned_intensity | رقم (1-10) | نعم | استعلام/جسم | الشدة المخطط للملء. |
recovery_score | رقم (0-100) | نعم | استعلام/جسم | درجة التعافي الإجمالية. |
sleep_hours | رقم (0-16) | نعم | استعلام/جسم | مدة النوم في الليلة الماضية. |
hrv | رقم (10-200) | نعم | استعلام/جسم | إدخال HRV المستخدم لتقييم الجاهزية. |
muscle_soreness | رقم (0-10) | نعم | استعلام/جسم | تقييم ذاتي للألم. |
goal | سلسلة | نعم | استعلام/جسم | fat_loss, muscle_gain, performance, maintenance, recomposition. |
lang | سلسلة | لا | استعلام | لغة الاستجابة (en, es, de, fr, pt, ja, hi, ar). |
لماذا استخدام هذه نقطة النهاية¶
- تقديم التنظيم الذاتي كخدمة لتطبيقات التدريب.
- تقليل خطر الإفراط في التدريب باستخدام مدخلات جاهزية موضوعية + ذاتية.
- توفير تعديلات جلسات قابلة للتفسير للرياضيين والمدربين.
مثال على الطلب¶
```bash
curl -X GET "https://api.hefitapi.com/api/v1/fitness/adaptive-training-load?planned_intensity=7&recovery_score=74&sleep_hours=7.2&hrv=58&muscle_soreness=4&goal=performance&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/adaptive-training-load/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
"planned_intensity": 7,
"recovery_score": 74,
"sleep_hours": 7.2,
"hrv": 58,
"muscle_soreness": 4,
"goal": "performance"
}'
## مثال على الاستجابة
!!! معلومات
مثال الاستجابة أدناه مخصص للأغراض التوضيحية فقط.
للحصول على بنية JSON الكاملة، في الوقت الفعلي، وربما أكثر ثراءً، قم بإرسال طلب حقيقي إلى هذه نقطة النهاية.
{
"planned_intensity": 7.0,
"adjusted_training_intensity_recommendation": 7.9,
"adjusted_training_intensity_delta": 0.9,
"volume_adjustment_percent": 8,
"decision": "push",
"decision_label": "Push",
"injury_probability_shift_percent_points": -1.8,
"performance_optimization_note": "Readiness supports a progressive session.",
"confidence_score": 87,
"confidence_label": "High",
"goal": "performance",
"goal_label": "Performance",
"readiness_signals": {
"recovery_score": 74.0,
"sleep_hours": 7.2,
"hrv": 58.0,
"muscle_soreness": 4.0,
"composite_readiness_score": 75.8
},
"recommended_action_blocks": [
"Increase load slightly on primary lift.",
"Keep movement quality high across sets."
],
"summary": "Train hard with quality control.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "35ce4816f312aa0b",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"api_name": "Health Fitness API by Dakidarts®",
"endpoint_name": "fitness_adaptive_training_load",
"response_language": "en"
}
}
الملاءمة السوقية¶
الأفضل للتدريب الاحترافي، ومراقبة الرياضيين، ومنتجات البرمجة التكيفية حيث تؤثر قرارات التدريب اليومية على الاحتفاظ والنتائج.
ملاحظة
يفرض التحقق من الصحة نطاقات صارمة للشدة ودرجة التعافي و-HRV والنوم والألم.
نقاط النهاية الموصى بها¶
-
GET /api/v1/fitness/cortisol-stress-load- واجهة برمجة تطبيقات تحميل الإجهاد الكورتيزول -
GET /api/v1/fitness/fasted-training-risk- واجهة برمجة تطبيقات خطر التدريب بعد الصيام -
GET /api/v1/fitness/training-archetype- واجهة برمجة تطبيقات نموذج التدريب -
GET /api/v1/fitness/volume-load-analysis- واجهة برمجة تطبيقات تحليل الحمل الحجمي -
GET /api/v1/bmi- واجهة برمجة تطبيقات BMI -
GET /api/v1/tdee- واجهة برمجة تطبيقات TDEE