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

واجهة برمجة تطبيقات لتتبع التعافي العضلي

احسب الوقت المناسب للتدريب على مجموعة عضلية بناءً على حجم التدريب، وعمر التدريب، والبروتين، وإدخالات التعافي أثناء النوم.

نقطة النهاية

  • GET /api/v1/fitness/muscle-recovery-timeline
  • POST /api/v1/fitness/muscle-recovery-timeline/post

المعلمات

الاسم النوع مطلوب الإدخال الوصف
muscle_group سلسلة نعم استعلام/جسم chest, back, legs, shoulders, arms, core, glutes, calves, full_body.
workout_intensity سلسلة نعم استعلام/جسم low, moderate, high, very_high, maximal.
total_sets عدد صحيح (1-60) نعم استعلام/جسم عدد المجموعات التي تم إكمالها في الجلسة.
training_age_years رقم (0-40) نعم استعلام/جسم الخبرة في التدريب بالسنوات.
protein_intake رقم (30-450) نعم استعلام/جسم كمية البروتين اليومية بالجرام.
sleep_hours رقم (0-16) نعم استعلام/جسم مدة النوم.
lang سلسلة لا استعلام لغة الاستجابة (en, es, de, fr, pt, ja, hi, ar).

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

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

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/fitness/muscle-recovery-timeline?muscle_group=legs&workout_intensity=high&total_sets=18&training_age_years=4&protein_intake=160&sleep_hours=6.8&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/muscle-recovery-timeline/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"muscle_group":"chest","workout_intensity":"very_high","total_sets":16,"training_age_years":2,"protein_intake":130,"sleep_hours":7.2}'

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

Info

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

{
  "muscle_group": "legs",
  "muscle_group_label": "Legs",
  "workout_intensity": "high",
  "workout_intensity_label": "High",
  "total_sets": 18,
  "training_age_years": 4.0,
  "protein_intake_g": 160.0,
  "sleep_hours": 6.8,
  "estimated_recovery_time_hours": 90,
  "optimal_retraining_window_hours": {"start": 84, "end": 108, "insight": "Allow full tissue recovery before repeat loading."},
  "overtraining_risk_if_trained_earlier": {"risk_score": 79, "risk_level": "very_high", "risk_label": "Very High", "insight": "Early retraining likely to reduce output and recovery."},
  "suggested_active_recovery_strategy": ["Low-intensity movement and mobility work"],
  "fatigue_carryover_warning": {"level": "severe", "level_label": "Severe", "warning": "High carryover fatigue risk from current session load."},
  "confidence_score": 73,
  "confidence_label": "Moderate",
  "recovery_driver_breakdown": {
    "base_hours": 72.0,
    "intensity_adjustment": 8.0,
    "set_volume_adjustment": 10.8,
    "training_age_adjustment": 0.0,
    "protein_adjustment": -2.0,
    "sleep_adjustment": 6.0
  },
  "summary": "Extended recovery window recommended before heavy retraining.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "0a26e0765f73ff84", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_muscle_recovery_timeline", "response_language": "en"}
}

وضع المنتج

مصمم للتدريب الاحترافي، وأتمتة التعافي، والبرامج عالية التكرار.

ملاحظة

تدعم total_sets 1-60؛ والقيم خارج هذا النطاق تُرجع HTTP 400.

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