واجهة برمجة التطبيقات (API) لتقدير الطاقة اليومية¶
تقدير التكلفة اليومية الكلية للطاقة باستخدام مسارات معادتي ميلفان أو هاريس.
نقطة النهاية¶
GET /api/v1/tdeePOST /api/v1/tdee/post
المعلمات¶
| الاسم | النوع | مطلوب | In | الوصف |
|---|---|---|---|---|
gender | سلسلة | نعم | استعلام/جسم | male أو female. |
age | عدد صحيح | نعم | استعلام/جسم | العمر بالسنوات. |
weight | رقم | نعم | استعلام/جسم | الوزن بالكيلوغرام. |
height | رقم | نعم | استعلام/جسم | الطول بالسنتيمتر. |
activity_level | سلسلة | نعم | استعلام/جسم | مفتاح النشاط المدعوم من مجموعة نقاط النهاية. |
equation | سلسلة | لا | استعلام/جسم | mifflin (افتراضي) أو harris. |
lang | سلسلة | لا | استعلام | لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar). |
لماذا استخدام هذه نقطة النهاية¶
- بناء أنظمة حساب السعرات الحرارية على أساس موثوق من التكلفة اليومية للطاقة.
- مقارنة المسارات للمعادلات مع الحفاظ على مخطط استجابة موحد.
- أتمتة أهداف فقدان/زيادة الوزن من خلال طلب واحد.
مثال على الطلب¶
curl -X GET "https://api.hefitapi.com/api/v1/tdee?gender=male&age=34&weight=82&height=178&activity_level=moderately_active&equation=mifflin&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/tdee/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"gender":"female","age":30,"weight":68,"height":167,"activity_level":"lightly_active","equation":"harris"}'
مثال على الاستجابة¶
معلومات
مثال الاستجابة أدناه مخصص للأغراض التوضيحية فقط. للحصول على الاستجابة الكاملة والواقعية وفي الوقت الفعلي، وربما أكثر غنى، قم بإجراء طلب حقيقي إلى هذه نقطة النهاية.
{
"TDEE": "2758.13 kcal/day",
"Gender": "Male",
"Age": "34 yr",
"Weight": "82.0 kg",
"Height": "178.0 cm",
"Activity Level": "Moderately Active",
"BMR": "1779.44 kcal/day",
"tdee_kcal_per_day": 2758.13,
"bmr_kcal_per_day": 1779.44,
"activity_multiplier": 1.55,
"equation_used": "mifflin",
"energy_band": "high",
"energy_band_label": "High",
"goal_targets_kcal_per_day": {"fat_loss": 2344, "maintenance": 2758, "muscle_gain": 3034},
"risk_signal": "Higher intake profile requires precision for composition goals.",
"action_plan": ["Track weekly trend and adjust in small steps"],
"monitoring_plan": "Review trend and intake adherence weekly.",
"language": "en",
"_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "f57b7f25a5607f29", "quota": 120, "usage_tracking": true},
"_api_metadata_": {"endpoint_name": "tdee", "response_language": "en"}
}
تحديد المنتج¶
واجهة برمجة التطبيقات الأساسية لمحركات التغذية، ومحطات حساب التمثيل الغذائي، ومنصات التدريب.
ملاحظة
تدعم equation فقط mifflin أو harris.
نقاط النهاية الموصى بها¶
GET /api/v1/bmi- واجهة برمجة تطبيقات (API) لـ BMIGET /api/v1/bmr- واجهة برمجة تطبيقات (API) لـ BMRGET /api/v1/protein-calculator- واجهة برمجة تطبيقات (API) لحساب البروتينGET /api/v1/fitness/heart-rate-zones- واجهة برمجة تطبيقات (API) لنطاقات معدل ضربات القلبGET /api/v1/bodyfat- واجهة برمجة تطبيقات (API) لـ BodyfatGET /api/v1/maintenance-calorie- واجهة برمجة تطبيقات (API) للسعرات الحرارية اللازمة