コンテンツにスキップ

筋肉回復スケジュール API

ワークロード、トレーニング期間、タンパク質摂取、睡眠回復などの入力に基づいて、どのタイミングで筋肉を再びトレーニングするかを計算します。

エンドポイント

  • GET /api/v1/fitness/muscle-recovery-timeline
  • POST /api/v1/fitness/muscle-recovery-timeline/post

パラメータ

名前 タイプ 必須 入力 説明
muscle_group 文字列 はい クエリ/ボディ chest,back,legs,shoulders,arms,core,glutes,calves,full_body。
workout_intensity 文字列 はい クエリ/ボディ low,moderate,high,very_high,maximal。
total_sets 整数 (1-60) はい クエリ/ボディ セッション中の完了したセット数。
training_age_years 数値 (0-40) はい クエリ/ボディ トレーニング経験（年単位）。
protein_intake 数値 (30-450) はい クエリ/ボディ 1日に摂取するタンパク質の量（グラム単位）。
sleep_hours 数値 (0-16) はい クエリ/ボディ 睡眠時間。
lang 文字列 いいえ クエリ レスポンス言語 (en,es,de,fr,pt,ja,hi,ar）。

このエンドポイントを使用する理由

  • 再トレーニングのタイミングに関する推測を排除します。
  • 過剰なトレーニングのリスクを定量化します。
  • 即時のアクティブ・リカバリーに関する推奨事項を提供します。

開始する

リクエストの例

curl -X GET "https://api.hefitapi.com/api/v1/fitness/muscle-recovery-timeline?muscle_group=legs&workout_intensity=high&total_sets=18&training_age_years=4&protein_intake=160&sleep_hours=6.8&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/muscle-recovery-timeline/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"muscle_group":"chest","workout_intensity":"very_high","total_sets":16,"training_age_years":2,"protein_intake":130,"sleep_hours":7.2}'

レスポンスの例

Info

以下のレスポンス例は、デモンストレーションのみを目的としています。 このエンドポイントに対して実際のリクエストを行うことで、完全でリアルタイム、およびより詳細なJSON構造を受け取ることができます。

{
  "muscle_group": "legs",
  "muscle_group_label": "Legs",
  "workout_intensity": "high",
  "workout_intensity_label": "High",
  "total_sets": 18,
  "training_age_years": 4.0,
  "protein_intake_g": 160.0,
  "sleep_hours": 6.8,
  "estimated_recovery_time_hours": 90,
  "optimal_retraining_window_hours": {"start": 84, "end": 108, "insight": "Allow full tissue recovery before repeat loading."},
  "overtraining_risk_if_trained_earlier": {"risk_score": 79, "risk_level": "very_high", "risk_label": "Very High", "insight": "Early retraining likely to reduce output and recovery."},
  "suggested_active_recovery_strategy": ["Low-intensity movement and mobility work"],
  "fatigue_carryover_warning": {"level": "severe", "level_label": "Severe", "warning": "High carryover fatigue risk from current session load."},
  "confidence_score": 73,
  "confidence_label": "Moderate",
  "recovery_driver_breakdown": {
    "base_hours": 72.0,
    "intensity_adjustment": 8.0,
    "set_volume_adjustment": 10.8,
    "training_age_adjustment": 0.0,
    "protein_adjustment": -2.0,
    "sleep_adjustment": 6.0
  },
  "summary": "Extended recovery window recommended before heavy retraining.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "0a26e0765f73ff84", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_muscle_recovery_timeline", "response_language": "en"}
}

製品ポジショニング

エリートコーチング、リカバリー自動化、高頻度トレーニングプログラム向けに設計されています。

注意

total_sets は 1-60 をサポートします。範囲外の値ではHTTP 400エラーが発生します。

推奨されるエンドポイント