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

واجهة برمجة التطبيقات MND

إرجاع نسب توزيع العناصر الغذائية الأساسية المصممة بناءً على مستوى النشاط والهدف من اللياقة البدنية.

نقطة النهاية

  • GET /api/v1/mnd
  • POST /api/v1/mnd/post

المعلمات

الاسم النوع مطلوب الإدخال الوصف
activity_level سلسلة نعم استعلام/جسم sedentary,moderately_active,very_active.
body_composition_goal سلسلة نعم استعلام/جسم weight_loss,maintenance,muscle_gain.
dietary_preferences سلسلة نعم استعلام/جسم سياق تفضيلات النص الحر.
lang سلسلة لا استعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

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

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

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/mnd?activity_level=moderately_active&body_composition_goal=weight_loss&dietary_preferences=high%20protein&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/mnd/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"activity_level":"very_active","body_composition_goal":"muscle_gain","dietary_preferences":"balanced"}'

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

معلومات

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

{
  "carbohydrates": "45.0%",
  "proteins": "30.0%",
  "fats": "25.0%",
  "macro_split_percent": {
    "carbohydrates": 45.0,
    "proteins": 30.0,
    "fats": 25.0
  },
  "activity_level": "moderately_active",
  "body_composition_goal": "weight_loss",
  "dietary_preferences": "high protein",
  "macro_strategy_band": "balanced",
  "macro_strategy_label": "Balanced",
  "risk_signal": "Macro split is suitable for broad adherence.",
  "action_plan": ["Track response and adjust based on trend"],
  "monitoring_plan": "Review progress weekly and tune if needed.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "f1e48e4b4d3d6a9a",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "mnd",
    "response_language": "en"
  }
}

وضع المنتج

نقطة نهاية تخطيط العناصر الغذائية الأساسية خفيفة الوزن لعمليات التسجيل والإرشاد والتخصيص.

ملاحظة

تعتبر activity_level و body_composition_goal قيمًا صارمة؛ فالقيم غير الصالحة ترجع HTTP 400.

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