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

واجهة برمجة التطبيقات (API) الخاصة بـ DCN

احسب السعرات الحرارية المستهدفة اليومية باستخدام معادلة ميفلين أو هاريز، ومعامل النشاط، وتعديل الهدف.

نقطة النهاية

  • GET /api/v1/dcn
  • POST /api/v1/dcn/post

المعلمات

الاسم النوع مطلوب In الوصف
age عدد صحيح نعم استعلام/جسم العمر بالسنوات.
weight رقم نعم استعلام/جسم الوزن بالكيلوغرام.
height رقم نعم استعلام/جسم الطول بالسنتيمتر.
gender سلسلة ((male,female)) نعم استعلام/جسم الجنس البيولوجي.
activity_level سلسلة نعم استعلام/جسم sedentary,lightly_active,moderately_active,very_active,extra_active.
goal سلسلة لا استعلام/جسم weight_loss,maintenance,weight_gain.
equation سلسلة لا استعلام mifflin أو harris.
lang سلسلة لا استعلام لغة الاستجابة ((en,es,de,fr,pt,ja,hi,ar)).

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

  • إنشاء توصيات قوية للسعرات الحرارية المستهدفة.
  • الحفاظ على الشفافية في الصيغ للامتثال والثقة.
  • ربط الأهداف الطاقية بالمستخدم في طلب API واحد.

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/dcn?age=36&weight=81&height=177&gender=male&activity_level=moderately_active&goal=maintenance&equation=mifflin&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/dcn/post?equation=mifflin&lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":36,"weight":81,"height":177,"gender":"male","activity_level":"moderately_active","goal":"maintenance"}'

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

معلومات

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

{
  "caloric_needs": {
    "equation": "mifflin",
    "goal": "maintenance",
    "calories": "2762.15 kcal/day"
  },
  "daily_calorie_target_kcal": 2762.15,
  "bmr_kcal_per_day": 1782.03,
  "activity_multiplier": 1.55,
  "profile": {
    "age": 36,
    "weight_kg": 81.0,
    "height_cm": 177.0,
    "gender": "male",
    "activity_level": "moderately_active",
    "goal": "maintenance",
    "equation": "mifflin"
  },
  "energy_band": "high",
  "energy_band_label": "High",
  "risk_signal": "Higher intake precision required.",
  "action_plan": ["Track trend weekly"],
  "monitoring_plan": "Adjust if weight trend drifts.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "bc434f88c1116d94",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "dcn",
    "response_language": "en"
  }
}

قيمة المنتج

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

ملاحظة

يتم تمرير equation كمعامل استعلام حتى لـ POST /dcn/post.

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