توقعات إعادة تكوين الجسم¶
تقدير مسار فقدان الدهون مقابل اكتساب العضلات واحتمالية النجاح في إعادة التكوين، بما في ذلك كتل التنبؤ لمدة 4/8/12 أسبوعًا.
نقطة النهاية¶
GET /api/v1/fitness/body-recomp-forecastPOST /api/v1/fitness/body-recomp-forecast/post
المعلمات¶
| الاسم | النوع | مطلوب | في | الوصف |
|---|---|---|---|---|
current_weight | رقم (35-300) | نعم | استعلام/جسم | الوزن الحالي بالكيلوغرام. |
body_fat_percentage | رقم (5-60) | نعم | استعلام/جسم | نسبة الدهون في الجسم الحالية. |
calorie_intake | رقم (800-6000) | نعم | استعلام/جسم | متوسط الاستهلاك اليومي. |
protein_intake | رقم (40-450) | نعم | استعلام/جسم | البروتين اليومي بالجرام. |
training_days | عدد صحيح (0-7) | نعم | استعلام/جسم | أيام تمارين القوة في الأسبوع. |
experience_level | سلسلة | نعم | استعلام/جسم | beginner,intermediate,advanced,elite. |
lang | سلسلة | لا | استعلام | لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar). |
لماذا استخدام هذه نقطة النهاية¶
- تحويل بيانات الاستهلاك/التدريب الثابتة إلى نتائج إعادة تكوين متوقعة.
- تحديد أولويات المستخدمين بناءً على احتمالية إعادة التكوين لتدخلات التدريب.
- تقديم رؤية زمنية لتحسين الامتثال والاحتفاظ.
مثال على الطلب¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast?current_weight=84&body_fat_percentage=24&calorie_intake=2350&protein_intake=165&training_days=4&experience_level=intermediate&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
"current_weight": 84,
"body_fat_percentage": 24,
"calorie_intake": 2350,
"protein_intake": 165,
"training_days": 4,
"experience_level": "intermediate"
}'
مثال على الاستجابة¶
معلومات
مثال الاستجابة أدناه مخصص للأغراض التوضيحية فقط. للحصول على بنية JSON الكاملة والواقعية وفي الوقت الفعلي، قد تكون أكثر ثراءً، قم بإرسال طلب مباشر إلى هذه نقطة النهاية.
{
"current_weight_kg": 84.0,
"body_fat_percentage": 24.0,
"calorie_intake": 2350,
"protein_intake_g": 165.0,
"training_days": 4,
"experience_level": "intermediate",
"experience_level_label": "Intermediate",
"estimated_fat_loss_vs_muscle_gain_ratio": {
"fat_loss_kg_per_week": 0.23,
"muscle_gain_kg_per_week": 0.13,
"fat_to_muscle_ratio": 1.77,
"ratio_label": "balanced_recomp",
"ratio_label_text": "Balanced recomp"
},
"recomp_probability_score": {
"score": 73,
"band": "moderate",
"band_label": "Moderate",
"insight": "Good potential with consistency."
},
"timeline_projection": [
{
"week": 4,
"projected_weight_kg": 83.6,
"projected_body_fat_percent": 23.2,
"estimated_fat_mass_change_kg": -0.92,
"estimated_lean_mass_change_kg": 0.52
}
],
"strategy_adjustment_advice": ["Keep protein high", "Maintain progressive overload"],
"metabolic_context": {
"estimated_maintenance_calories": 2720,
"daily_energy_gap": -370,
"protein_g_per_kg": 1.96
},
"confidence_score": 84,
"summary": "Consistent execution can deliver measurable recomposition.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "4b2ad1f68d3dc50a",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"api_name": "Health Fitness API by Dakidarts®",
"endpoint_name": "fitness_body_recomp_forecast",
"response_language": "en"
}
}
تحديد السوق¶
مثالية لمنصات التدريب عالية المشاركة ومنتجات اللياقة البدنية المميزة حيث يحتاج المستخدمون إلى توقعات متقدمة بناءً على الاحتمالات.
ملاحظة
يتم التحقق من صحة جميع المدخلات ضمن النطاقات (الوزن، الدهون في الجسم، السعرات الحرارية، البروتين، وأيام التدريب) بشكل صارم.
نقاط النهاية الموصى بها¶
GET /api/v1/bmi- واجهة برمجة تطبيقات BMIGET /api/v1/tdee- واجهة برمجة تطبيقات TDEEGET /api/v1/bmr- واجهة برمجة تطبيقات BMRGET /api/v1/protein-calculator- واجهة برمجة تطبيقات حاسبة البروتينGET /api/v1/fitness/heart-rate-zones- واجهة برمجة تطبيقات نطاقات معدل ضربات القلبGET /api/v1/bodyfat- واجهة برمجة تطبيقات الدهون في الجسم