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

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

حساب كمية الكربوهيدرات الموصى بها بناءً على الجنس، والعمر، والقياسات الجسدية، و TDEE (الاستهلاك اليومي للطاقة) القائم على النشاط.

نقطة النهاية

  • GET /api/v1/carbs-calculator
  • POST /api/v1/carbs-calculator/post

المعلمات

الاسم النوع مطلوب In الوصف
sex سلسلة (male,female) نعم استعلام/جسم الجنس البيولوجي.
age رقم نعم استعلام/جسم العمر بالسنوات.
height رقم نعم استعلام/جسم الطول (وحدة القياس: cm, وحدة القياس: in).
weight رقم نعم استعلام/جسم الوزن (وحدة القياس: kg, وحدة القياس: lb).
unit سلسلة (metric,imperial) لا استعلام/جسم وضع وحدة الإدخال. القيمة الافتراضية: metric.
activity_level سلسلة نعم استعلام/جسم sedentary,lightly_active,moderately_active,very_active,extra_active.
lang سلسلة لا استعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

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

  • تحويل بيانات الملف الشخصي إلى أهداف كربوهيدرات قابلة للتنفيذ.
  • تمكين التوزيع الكربوهيدراتي (الكميات المختلفة) ليوم التدريب/يوم الراحة.
  • تحسين تخصيص خطط التغذية في تطبيقات التدريب.

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/carbs-calculator?sex=male&age=31&height=178&weight=82&unit=metric&activity_level=moderately_active&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/carbs-calculator/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sex":"male","age":31,"height":178,"weight":82,"unit":"metric","activity_level":"moderately_active"}'

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

معلومات

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

{
  "sex": "male",
  "age": 31.0,
  "height_cm": 178.0,
  "weight_kg": 82.0,
  "unit": "metric",
  "activity_level": "moderately_active",
  "tdee_kcal_per_day": 2870.16,
  "usda_carbs_grams_range": [322.89, 466.4],
  "recommended_carbs_g": 394.65,
  "carb_band": "high",
  "carb_band_label": "High",
  "periodization_targets_g": {
    "rest_day": 355.19,
    "training_day": 434.12
  },
  "timing_guidance": ["Place larger carb portions around training"],
  "action_plan": ["Prioritize complex carbs", "Track response weekly"],
  "adjustment_rules": ["Reduce carbs if fat gain accelerates"],
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "2c8d9bd88b6f2f19",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "carbs_calculator",
    "response_language": "en"
  }
}

قيمة المنتج

مناسب بشكل كبير لبرامج SaaS للتخطيط الغذائي، وأدوات أتمتة التغذية، ومنتجات التدريب.

ملاحظة

يجب أن تتطابق activity_level مع أحد قيم المجموعة المدعومة تمامًا.

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