واجهة برمجة تطبيقات لتخطيط الترطيب¶
إنشاء إرشادات ترطيب مناسبة للشركات بناءً على الوزن، ودرجة الحرارة المحيطة، ومدة التدريب.
نقطة النهاية¶
GET /api/v1/fitness/hydration-planPOST /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.
نقاط النهاية الموصى بها¶
GET /api/v1/fitness/daily-plan- واجهة برمجة تطبيقات لخطة اليومGET /api/v1/fitness/deload-plan- واجهة برمجة تطبيقات لخطة التخفيفGET /api/v1/fitness/glycogen-replenishment-plan- واجهة برمجة تطبيقات لخطة تجديد الجليكوجينGET /api/v1/fitness/reverse-diet-plan- واجهة برمجة تطبيقات لخطة النظام الغذائي المعكوسGET /api/v1/fitness/weekly-plan- واجهة برمجة تطبيقات لخطة الأسبوعGET /api/v1/bmi- واجهة برمجة تطبيقات BMI