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

واجهة برمجة التطبيقات (API) للأهداف التدريجية

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

نقطة النهاية (Endpoint)

  • GET /api/v1/fitness/progression-targets
  • POST /api/v1/fitness/progression-targets/post

المعلمات

الاسم النوع مطلوب In الوصف
goal سلسلة نصية نعم استعلام/جسم fat_loss,muscle_gain,maintenance,endurance,recomposition.
current_weight رقم (35-300) نعم استعلام/جسم الوزن الحالي بالكيلوغرام.
time_horizon_weeks عدد صحيح (2-52) نعم استعلام/جسم الإطار الزمني المستهدف بالأيام.
lang سلسلة نصية لا استعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

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

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

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/fitness/progression-targets?goal=recomposition&current_weight=82&time_horizon_weeks=12&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/progression-targets/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"goal":"fat_loss","current_weight":91,"time_horizon_weeks":16}'

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

معلومات

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

{
  "goal": "recomposition",
  "goal_label": "Recomposition",
  "current_weight_kg": 82.0,
  "time_horizon_weeks": 12,
  "weekly_target_change_kg": -0.12,
  "safe_progression_bounds": {
    "weekly_change_kg_min": -0.33,
    "weekly_change_kg_max": 0.08,
    "total_change_kg_min": -3.94,
    "total_change_kg_max": 0.98
  },
  "weekly_targets": [
    {"week": 1, "target_weight_kg": 81.88, "change_from_start_kg": -0.12},
    {"week": 2, "target_weight_kg": 81.75, "change_from_start_kg": -0.25}
  ],
  "weekly_execution_targets": ["Hold protein and progressive training consistency"],
  "course_correction_triggers": ["Adjust intake if trend diverges for 2 consecutive weeks"],
  "compliance_scorecard": ["Track adherence to training, sleep, and nutrition"],
  "review_schedule": {"weekly": "trend review", "monthly": "strategy adjustment"},
  "summary": "Gradual progression target supports sustainable recomposition.",
  "adjustment_logic": "Use small weekly adjustments while preserving performance.",
  "safety_note": "Avoid aggressive shifts outside safe progression bounds.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "5df3ca7f3f4bad5e", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_progression_targets", "response_language": "en"}
}

وضع المنتج

مصمم لمجموعات التدريب والتطبيقات لتحويل الجسم ولوحات تحليلات التقدم.

ملاحظة

يجب أن يكون time_horizon_weeks بين 2 و 52.

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