واجهة برمجة التطبيقات (API) لحساب احتياجات الطاقة الأساسية¶
حساب احتياجات الطاقة الأساسية وإنتاج مخرجات تخطيط مفيدة لفقدان الدهون، والحفاظ على الوزن، وكتلة العضلات.
نقطة النهاية (Endpoint)¶
GET /api/v1/bmrPOST /api/v1/bmr/post
المعلمات¶
| الاسم | النوع | مطلوب | In | الوصف |
|---|---|---|---|---|
age | عدد صحيح | نعم | استعلام/جسم | العمر بالسنوات. |
weight | رقم | نعم | استعلام/جسم | الوزن بالكيلوجرام. |
height | رقم | نعم | استعلام/جسم | الطول بالسنتيمتر. |
gender | سلسلة (،،) | نعم | استعلام/جسم | الجنس البيولوجي. |
equation | سلسلة (،،) | لا | استعلام | محدد الصيغة (القيمة الافتراضية هي ) |
lang | سلسلة | لا | استعلام | لغة الاستجابة (،،،،،،،،،،،) |
لماذا استخدام هذه نقطة النهاية¶
- دعم تخطيط السعرات الحرارية في عمليات الإعداد والتدريب.
- مقارنة سلوك المعادلة مع التحكم المباشر في الصيغة.
- إضافة نطاقات أيض قابلة للتفسير لمحركات التخصيص.
مثال على الطلب¶
curl -X GET "https://api.hefitapi.com/api/v1/bmr?age=34&weight=78&height=175&gender=male&equation=mifflin&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/bmr/post?equation=mifflin&lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"age": 34, "weight": 78, "height": 175, "gender": "male"}'
مثال على الاستجابة¶
معلومات
مثال الاستجابة أدناه مخصص للأغراض التوضيحية فقط. للحصول على الاستجابة الكاملة في الوقت الفعلي وربما أكثر ثراءً، قم بإرسال طلب إلى هذه نقطة النهاية.
{
"bmr": "1708.75 kcal/day",
"bmr_kcal_per_day": 1708.75,
"profile": {
"age": 34,
"weight_kg": 78.0,
"height_cm": 175.0,
"gender": "male",
"equation": "mifflin"
},
"metabolic_band": "moderate",
"metabolic_band_label": "Moderate",
"target_calorie_ranges": {
"fat_loss": 1743,
"maintenance_proxy": 2221,
"muscle_gain": 2392
},
"risk_signal": "Energy needs are moderate and manageable.",
"action_plan": ["Align intake with goal phase", "Track weekly response"],
"monitoring_plan": "Recalculate when weight changes materially.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "b76dbf5f8f5729c1",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"api_name": "Health Fitness API by Dakidarts®",
"endpoint_name": "bmr",
"response_language": "en"
}
}
تحديد المنتج¶
نقطة النهاية الأساسية لتطبيقات SaaS للتغذية، وتطبيقات التدريب، وأنظمة الصحة المؤسسية التي تحتاج إلى نمذجة أساسية للطاقة.
ملاحظة
يتم تمرير equation كمعامل استعلام في كلا طريقتي GET و POST.
نقاط النهاية الموصى بها¶
GET /api/v1/bmi- واجهة برمجة تطبيقات (API) لحساب مؤشر كتلة الجسم (BMI)GET /api/v1/tdee- واجهة برمجة تطبيقات (API) لحساب السعرات الحرارية اليومية (TDEE)GET /api/v1/protein-calculator- واجهة برمجة تطبيقات (API) لحساب البروتينGET /api/v1/fitness/heart-rate-zones- واجهة برمجة تطبيقات (API) لنطاقات معدل ضربات القلبGET /api/v1/bodyfat- واجهة برمجة تطبيقات (API) لحساب الدهون في الجسمGET /api/v1/maintenance-calorie- واجهة برمجة تطبيقات (API) لحساب السعرات الحرارية للحفاظ على الوزن