コンテンツにスキップ

プログレッシブ目標 API

減量、増加、維持、持久力、または再構成の目標に対する段階的な進捗スケジュールを生成します。

エンドポイント

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

パラメータ

名前 タイプ 必須 Query/Body 説明
goal 文字列 はい Query/Body fat_loss, muscle_gain, maintenance, endurance, recomposition
current_weight 数値 (35-300) はい Query/Body 現在の体重 (kg)。
time_horizon_weeks 整数 (2-52) はい Query/Body 目標期間 (週)。
lang 文字列 いいえ Query レスポンス言語 (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}'

レスポンスの例

Info

以下のレスポンスの例は、デモンストレーションのみを目的としています。 このエンドポイントに対してライブリクエストを実行して、完全でリアルタイム、および潜在的に豊富な 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 の間でなければなりません。

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