水分補給計画 API¶
体重、周囲温度、およびトレーニング期間から、ビジネス利用に適した水分補給計画を生成します。
エンドポイント¶
GET /api/v1/fitness/hydration-planPOST /api/v1/fitness/hydration-plan/post
パラメータ¶
| 名前 | タイプ | 必須 | In | 説明 |
|---|---|---|---|---|
weight | 数値 (35-300) | はい | クエリ/ボディ | 体重(キログラム)。 |
temperature_c | 数値 (-10 から 55) | はい | クエリ/ボディ | 周囲温度(摂氏)。 |
training_minutes | 整数 (0-360) | はい | クエリ/ボディ | 1日のトレーニング期間。 |
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}'
レスポンスの例¶
Info
以下のレスポンス例は、デモンストレーションのみを目的としています。 このエンドポイントに対してライブリクエストを実行して、完全でリアルタイム、およびより詳細な 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- 1日計画 APIGET /api/v1/fitness/deload-plan- deload計画 APIGET /api/v1/fitness/glycogen-replenishment-plan- グリコーゲン補給計画 APIGET /api/v1/fitness/reverse-diet-plan- 反転ダイエット計画 APIGET /api/v1/fitness/weekly-plan- 週間計画 APIGET /api/v1/bmi- BMI API