واجهة برمجة تطبيقات السعرات الحرارية للصيانة¶
احسب معدل الأيض الأساسي والسعرات الحرارية اللازمة للصيانة مع نطاقات مستهدفة عملية لفقدان الدهون وكتلة العضلات.
نقطة النهاية¶
GET /api/v1/maintenance-caloriePOST /api/v1/maintenance-calorie/post
المعلمات¶
| الاسم | النوع | مطلوب | In | الوصف |
|---|---|---|---|---|
sex | سلسلة | نعم | استعلام/جسم | male أو female. |
age | رقم (>0) | نعم | استعلام/جسم | العمر بالسنوات. |
height | رقم (>0) | نعم | استعلام/جسم | الطول بالسنتيمتر (metric) أو البوصات (imperial). |
weight | رقم (>0) | نعم | استعلام/جسم | الوزن بالكيلوجرام (metric) أو الأوقية (imperial). |
unit | سلسلة | نعم | استعلام/جسم | metric أو imperial. |
activity_level | سلسلة | نعم | استعلام/جسم | little/no exercise, 1-2 times/week, 2-3 times/week, 3-5 times/week, 6-7 times/week, pro athlete. |
lang | سلسلة | لا | استعلام | لغة الاستجابة (en, es, de, fr, pt, ja, hi, ar). |
لماذا يجب استخدام هذه نقطة النهاية¶
- توفير أساس مستقر للسعرات الحرارية قبل التخطيط للمغذيات.
- إرجاع نطاقات مستهدفة لفقدان الدهون، والصيانة، والنمو.
- تحسين الامتثال من خلال حقول التوجيه والمراقبة.
مثال على الطلب¶
curl -X GET "https://api.hefitapi.com/api/v1/maintenance-calorie?sex=female&age=31&height=167&weight=68&unit=metric&activity_level=3-5%20times/week&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/maintenance-calorie/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"sex":"male","age":36,"height":71,"weight":186,"unit":"imperial","activity_level":"2-3 times/week"}'
مثال على الاستجابة¶
معلومات
مثال الاستجابة أدناه هو لأغراض العرض التوضيحي فقط. للحصول على بنية JSON الكاملة والواقعية وفي الوقت الفعلي، قد يكون من الضروري إجراء طلب مباشر إلى هذه نقطة النهاية.
{
"sex": "female",
"age": 31.0,
"height_cm": 167.0,
"weight_kg": 68.0,
"unit": "metric",
"activity_level": "3-5 times/week",
"bmr_kcal_per_day": 1417.75,
"activity_multiplier": 1.75,
"m_calorie_kcal_per_day": 2481.06,
"calorie_band": "moderate",
"calorie_band_label": "Moderate",
"goal_targets_kcal": {
"fat_loss": 2109,
"maintenance": 2481,
"muscle_gain": 2729
},
"priority_focus": ["Track adherence before major changes"],
"activity_guidance": ["Sustain weekly movement consistency"],
"adjustment_rules": ["Adjust by 100-150 kcal based on trend"],
"monitoring_plan": "Review bodyweight and energy levels weekly.",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "d21562072ea3f83f",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"endpoint_name": "maintenance_calorie",
"response_language": "en"
}
}
وضع المنتج¶
نقطة النهاية الأساسية لمجموعات التغذية، وأنظمة إدارة علاقات العملاء للتدريب، والبرامج الصحية الرقمية.
ملاحظة
يجب أن تتطابق activity_level مع أحد السلاسل المدعومة بالضبط.
نقاط النهاية الموصى بها¶
GET /api/v1/meal-calorie-calculator- واجهة برمجة تطبيقات حاسبة السعرات الحرارية للمشروباتGET /api/v1/fitness/workout-calorie-estimate- واجهة برمجة تطبيقات تقدير السعرات الحرارية للتمارين الرياضيةGET /api/v1/bmi- واجهة برمجة تطبيقات BMIGET /api/v1/tdee- واجهة برمجة تطبيقات TDEEGET /api/v1/bmr- واجهة برمجة تطبيقات BMRGET /api/v1/protein-calculator- واجهة برمجة تطبيقات حاسبة البروتين