واجهة برمجة التطبيقات EER¶
حساب قيم EER وإرجاع أهداف سعوية عملية لفقدان الوزن، والحفاظ عليه، وكتلة العضلات.
نقطة النهاية¶
GET /api/v1/eerPOST /api/v1/eer/post
المعلمات¶
| الاسم | النوع | مطلوب | In | الوصف |
|---|---|---|---|---|
gender | سلسلة (male,female) | نعم | استعلام/جسم | الجنس البيولوجي. |
age | عدد صحيح | نعم | استعلام/جسم | العمر بالسنوات. |
weight | رقم | نعم | استعلام/جسم | الوزن بالكيلوجرام. |
height | رقم | نعم | استعلام/جسم | الطول بالسنتيمتر. |
activity_level | سلسلة | نعم | استعلام/جسم | sedentary,low active,active,very active. |
lang | سلسلة | لا | استعلام | لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar). |
لماذا استخدام هذه نقطة النهاية¶
- إنشاء ميزانية سعوية قائمة على الأدلة باستخدام الصيغ القياسية.
- إضافة رؤية لعامل النشاط لتعليم المستخدم.
- دعم التخطيط الغذائي الشخصي على نطاق واسع.
مثال على الطلب¶
curl -X GET "https://api.hefitapi.com/api/v1/eer?gender=female&age=34&weight=66&height=168&activity_level=active&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/eer/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"gender":"female","age":34,"weight":66,"height":168,"activity_level":"active"}'
مثال على الاستجابة¶
معلومات
مثال الاستجابة أدناه هو لأغراض العرض التوضيحي فقط. للحصول على بنية JSON الكاملة والواقعية وفي الوقت الفعلي وربما أكثر ثراء، قم بإرسال طلب حقيقي إلى هذه نقطة النهاية.
{
"EER": "2351.36 kcal/day",
"Gender": "female",
"Age": "34 yr",
"Weight": "66.0 kg",
"Height": "168.0 cm",
"Activity Level": "active",
"eer_kcal_per_day": 2351.36,
"activity_factor": 1.27,
"energy_band": "moderate",
"energy_band_label": "Moderate",
"goal_targets_kcal_per_day": {
"fat_loss": 1999,
"maintenance": 2351,
"muscle_gain": 2587
},
"risk_signal": "Energy requirement is moderate.",
"action_plan": ["Match intake to goal phase"],
"monitoring_plan": "Recompute on profile changes.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "54d8b43189e1ec8c",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"endpoint_name": "eer",
"response_language": "en"
}
}
الاستخدام التجاري¶
مناسبة لمحركات التغذية، وخدمات SaaS للتدريب، ومنصات الصحة والرفاهية المؤسسية.
ملاحظة
يجب أن تتطابق activity_level مع قيم تعداد نقطة النهاية تمامًا.
نقاط النهاية الموصى بها¶
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- واجهة برمجة تطبيقات الدهون في الجسم