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

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

إنشاء توصيات غذائية ومقاييس محسنة حسب الهدف ومستوى النشاط.

نقطة النهاية

  • GET /api/v1/fitness/macro-cycling
  • POST /api/v1/fitness/macro-cycling/post

المعلمات

الاسم النوع مطلوب في الوصف
goal سلسلة نعم استعلام/جسم fat_loss,muscle_gain,maintenance,endurance,recomposition.
weight رقم (35-300) نعم استعلام/جسم وزن الجسم بالكيلوجرام.
activity_level سلسلة نعم استعلام/جسم sedentary,light,moderate,active,athlete.
lang سلسلة لا استعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

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

  • دعم تقسيم السعرات الحرارية في أدوات التدريب للمستهلكين والاحترافيين.
  • تحديد أهداف التغذية ليوم التمرين وأيامه.
  • إضافة كتل منطقية للشركات لتنفيذ التحكم في المخاطر.

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/fitness/macro-cycling?goal=fat_loss&weight=82&activity_level=moderate&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/macro-cycling/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"goal":"muscle_gain","weight":78,"activity_level":"active"}'

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

معلومات

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

{
  "goal": "fat_loss",
  "goal_label": "Fat Loss",
  "weight_kg": 82.0,
  "activity_level": "moderate",
  "activity_label": "Moderate",
  "target_daily_calories": 2544,
  "macro_cycling": {
    "training_day": {
      "calories": 2694,
      "protein_g": 229,
      "carbs_g": 242,
      "fats_g": 90
    },
    "rest_day": {
      "calories": 2394,
      "protein_g": 203,
      "carbs_g": 168,
      "fats_g": 101
    }
  },
  "adjustment_logic": "Lower calories on rest days while preserving protein adequacy.",
  "implementation_suggestions": ["Keep weekly average aligned with goal"],
  "risk_controls": ["Avoid aggressive day-to-day swings"],
  "weekly_checkin_rules": ["Recalibrate if scale trend stalls for 2 weeks"],
  "summary": "Macro cycling profile supports steady fat-loss progression.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "e4517ab38f59ed67",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "fitness_macro_cycling",
    "response_language": "en"
  }
}

تحديد المنتج

ممتاز لمخططي التغذية المتقدمين، ومجموعات التدريب عالية التأثير، وتطبيقات الأداء.

ملاحظة

يجب أن تكون goal و activity_level من قوائم القيم المدعومة، أو يجب أن تُرجع API رمز HTTP 400.

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