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

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

إنشاء إرشادات ترطيب مناسبة للشركات بناءً على الوزن، ودرجة الحرارة المحيطة، ومدة التدريب.

نقطة النهاية

  • GET /api/v1/fitness/hydration-plan
  • POST /api/v1/fitness/hydration-plan/post

المعلمات

الاسم النوع مطلوب في الوصف
weight رقم (35-300) نعم استعلام/جسم وزن الجسم بالكيلوجرام.
temperature_c رقم (-10 إلى 55) نعم استعلام/جسم درجة الحرارة المحيطة بالدرجة المئوية.
training_minutes عدد صحيح (0-360) نعم استعلام/جسم مدة التدريب اليومية.
lang سلسلة لا استعلام لغة الاستجابة (en, es, de, fr, pt, ja, hi, ar).

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

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

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/fitness/hydration-plan?weight=78&temperature_c=31&training_minutes=75&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/hydration-plan/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"weight":78,"temperature_c":31,"training_minutes":75}'

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

معلومات

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

{
  "weight_kg": 78.0,
  "temperature_c": 31.0,
  "training_minutes": 75,
  "training_load": "moderate",
  "training_load_label": "Moderate",
  "heat_profile": "high",
  "heat_profile_label": "High",
  "hydration_plan": {
    "baseline_hydration_liters": 2.57,
    "workout_hydration_liters": 0.75,
    "heat_adjustment_liters": 1.35,
    "total_daily_target_liters": 4.67
  },
  "daily_hydration_baseline_liters": 2.57,
  "electrolyte_targets": {
    "sodium_mg": 1638,
    "potassium_mg": 504,
    "magnesium_mg": 116
  },
  "timing_protocol": {
    "pre_training": {"volume_liters": 0.51, "instruction": "Hydrate before session start."},
    "during_training": {"volume_liters": 0.72, "instruction": "Use steady fluid intake during training."},
    "post_training": {"volume_liters": 1.68, "instruction": "Rehydrate in the first recovery window."}
  },
  "adjustment_logic": "Increase fluid and sodium as heat and duration rise.",
  "scenario_guidance": ["Prioritize cooling and frequent sips"],
  "rapid_adjustment_rules": ["Add electrolytes for longer sessions"],
  "next_check_protocol": {"window_hours": 24, "metric": "hydration compliance"},
  "risk_flags": ["Heat stress risk elevated", "Electrolyte gap risk"],
  "summary": "Elevated hydration and electrolyte support advised.",
  "recommendations": [
    "Increase hydration volumes for moderate training load.",
    "Use pre, intra, and post-workout intake timing."
  ],
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "fc6d8cc3f0b14fb2",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "fitness_hydration_plan",
    "response_language": "en"
  }
}

وضع المنتج

مثالي لتطبيقات الرياضة والأجهزة القابلة للارتداء للرفاهية وأنظمة التدريب المؤسسية التي تحتاج إلى أتمتة الترطيب الذكية بناءً على المناخ.

ملاحظة

تدعم training_minutes 0-360؛ القيم خارج النطاق تُرجع HTTP 400.

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