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

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

إنشاء قيم الكيتو الرئيسية (البروتينات، الكربوهيدرات، الدهون) بناءً على سيناريوهات "تقليل الوزن"، "الحفاظ على الوزن"، أو "زيادة الوزن" مع مراعاة السعرات الحرارية الحالية والهدف.

نقطة النهاية

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

المعلمات

الاسم النوع مطلوب في الوصف
sex سلسلة نعم استعلام/جسم male أو female.
weight رقم نعم استعلام/جسم الوزن بالكيلوغرام (metric) أو بالرطل (imperial).
height رقم نعم استعلام/جسم الطول بالسنتيمتر (metric) أو البوصة (imperial).
age عدد صحيح نعم استعلام/جسم العمر بالسنوات.
activity_level سلسلة لا استعلام/جسم sedentary, lightly_active, moderately_active, very_active, extra_active, athlete.
target_weight رقم لا استعلام/جسم الوزن المستهدف للجسم؛ افتراضيًا يكون الوزن الحالي.
diet سلسلة لا استعلام/جسم normal أو strict.
unit سلسلة لا استعلام/جسم metric (افتراضي) أو imperial.
lang سلسلة لا استعلام لغة الاستجابة (en, es, de, fr, pt, ja, hi, ar).

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

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

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/keto-calculator?sex=female&weight=68&height=167&age=31&activity_level=moderately_active&target_weight=63&diet=strict&unit=metric&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/keto-calculator/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sex":"male","weight":186,"height":71,"age":36,"activity_level":"very_active","target_weight":180,"diet":"normal","unit":"imperial"}'

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

معلومات

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

{
  "recommended_calories": {
    "target_weight": "1760 kcal/day",
    "current_weight": "2200 kcal/day"
  },
  "fats": {
    "percentage": "70 %",
    "kcal_per_day": "1232 kcal/day",
    "grams_per_day": "136.9 g/day",
    "grams_per_day_tdee": "171.1 g/day"
  },
  "carbohydrates": {
    "percentage": "5 %",
    "kcal_per_day": "88 kcal/day",
    "grams_per_day": "22.0 g/day",
    "grams_per_day_tdee": "27.5 g/day"
  },
  "proteins": {
    "percentage": "25 %",
    "kcal_per_day": "440 kcal/day",
    "grams_per_day": "110.0 g/day",
    "grams_per_day_tdee": "137.5 g/day"
  },
  "goal_mode": "cut",
  "goal_mode_label": "Fat Loss",
  "diet_profile": "Strict keto profile.",
  "activity_context": "Moderate activity workload.",
  "action_plan": ["Keep carbs tightly controlled around schedule"],
  "monitoring_plan": "Audit adherence and trend weekly.",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "8fe037e14926af3b",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "keto_calculator",
    "response_language": "en"
  }
}

وضع المنتج

جاهز للاستخدام لمدربي الكيتو، ومنصات تخطيط الوجبات كبرامج SaaS، و سير العمل الغذائية المؤسسية.

ملاحظة

إرجاع قيمة غير صحيحة لـ activity_level، أو diet، أو unit يؤدي إلى إرجاع خطأ HTTP 400.

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