انتقل إلى المحتوى

واجهة برمجة تطبيقات لحساب السعرات الحرارية للوجبات

إرجاع نطاقات السعرات الحرارية الموصى بها لكل نافذة وجبات بناءً على الملف الشخصي، ومستوى النشاط، وتكرار الوجبات.

نقطة النهاية

  • GET /api/v1/meal-calorie-calculator
  • POST /api/v1/meal-calorie-calculator/post

المعلمات

الاسم النوع مطلوب في الوصف
sex سلسلة نعم استعلام/جسم أو female.
age رقم (>0) نعم استعلام/جسم العمر بالسنوات.
height رقم (>0) نعم استعلام/جسم الطول بالسنتيمتر (metric) أو البوصة (imperial).
weight رقم (>0) نعم استعلام/جسم الوزن بالكيلوجرام (metric) أو الأوقية (imperial).
activity_level سلسلة نعم استعلام/جسم مجموعة الخيارات المدعومة لنوع النشاط من نقطة النهاية.
meals_per_day عدد صحيح لا استعلام/جسم 3, 4, أو 5 (افتراضي: 3).
unit سلسلة لا استعلام/جسم metric (افتراضي) أو imperial.
lang سلسلة لا استعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

لماذا استخدام هذه نقطة النهاية

  • تحويل أهداف السعرات الحرارية اليومية إلى توزيع عملي للوجبات.
  • إنشاء مخططات وجبات تتكيف مع ملف تعريف النشاط.
  • توفير حقول استراتيجية لتحسين تجربة المستخدم.

ابدأ الآن

مثال على الطلب

curl -X GET "https://api.hefitapi.com/api/v1/meal-calorie-calculator?sex=female&age=31&height=167&weight=68&unit=metric&activity_level=3-4%20times/week&meals_per_day=4&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/meal-calorie-calculator/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","meals_per_day":5}'

مثال على الاستجابة

معلومات

مثال الاستجابة أدناه مخصص لأغراض العرض التوضيحي فقط. للحصول على هيكل JSON الكامل والواقعي وفي الوقت الفعلي، قم بإرسال طلب إلى هذه نقطة النهاية.

{
  "sex": "female",
  "age": 31.0,
  "height_cm": 167.0,
  "weight_kg": 68.0,
  "unit": "metric",
  "activity_level": "3-4 times/week",
  "activity_factor": 1.625,
  "meals_per_day": 4,
  "maintenance_calories_per_day": 2304,
  "intake_band": "moderate",
  "intake_band_label": "Moderate",
  "meal_calories": {
    "breakfast": {"min": 576, "max": 691, "recommended": 634},
    "morning_snack": {"min": 115, "max": 230, "recommended": 173},
    "lunch": {"min": 806, "max": 922, "recommended": 864},
    "dinner": {"min": 576, "max": 691, "recommended": 634}
  },
  "distribution_strategy": ["Anchor lunch as highest-calorie meal"],
  "timing_guidance": ["Place carbs near training windows"],
  "quality_guardrails": ["Prioritize whole-food meal construction"],
  "adjustment_rules": ["Adjust meal split if satiety drops"],
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "47db8fcb13cc92d5",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "meal_calorie_calculator",
    "response_language": "en"
  }
}

وضع المنتج

الأفضل لتطبيقات SaaS للتخطيط للوجبات، وتطبيقات تتبع التغذية، ومنتجات التدريب الرقمي.

ملاحظة

تدعم meals_per_day فقط 3, 4, أو 5.

نقاط النهاية الموصى بها