コンテンツにスキップ

レース時間予測 API

現在のパフォーマンスとコンディショニング指標に基づいて、レースの結果を予測します。

エンドポイント

  • GET /api/v1/fitness/race-time-predictor
  • POST /api/v1/fitness/race-time-predictor/post

パラメータ

名前 タイプ 必須 クエリ/ボディ 説明
recent_5k_time 文字列/数値 はい クエリ/ボディ 5K の時間（mm:ss、hh:mm:ss、または分で）。
vo2max 数値 (20-90) はい クエリ/ボディ VO2 max の値。
weekly_mileage 数値 (0-250) はい クエリ/ボディ 1週間の走行距離（km）。
lang 文字列 いいえ クエリ レスポンス言語（en、es、de、fr、pt、ja、hi、ar）。

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

  • 現在のフィットネス指標に基づいて、レースの予測を提供します。
  • 実行計画に、準備と自信のコンテキストを追加します。
  • ランニングアプリにおけるペース設定と目標設定のワークフローを改善します。

開始する

リクエストの例

curl -X GET "https://api.hefitapi.com/api/v1/fitness/race-time-predictor?recent_5k_time=22:30&vo2max=49&weekly_mileage=42&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/race-time-predictor/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"recent_5k_time":"23:45","vo2max":45,"weekly_mileage":34}'

レスポンスの例

Info

以下のレスポンスの例は、デモンストレーションのみを目的としています。 完全な、リアルタイム、および潜在的により詳細な JSON 構造を取得するには、このエンドポイントに対してライブリクエストを実行してください。

{
  "recent_5k_time": "22:30",
  "vo2max": 49.0,
  "weekly_mileage_km": 42.0,
  "readiness_band": {
    "level": "developing",
    "level_label": "Developing",
    "insight": "Fitness profile supports progressive race-specific work."
  },
  "projection_10k": {"time": "47:22", "seconds": 2842},
  "projection_half_marathon": {"time": "1:44:50", "seconds": 6290},
  "projection_marathon": {"time": "3:39:25", "seconds": 13165},
  "training_focus": "Build threshold consistency and long-run efficiency.",
  "confidence_score": 86,
  "summary": "Solid progression profile with actionable race readiness.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "b84e92708fac339d", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_race_time_predictor", "response_language": "en"}
}

製品ポジショニング

ランニングコーチの SaaS、エンデュランス計画アプリ、およびレース準備製品向けのプレミアム機能。

備考

recent_5k_time は、現実的な 5K の範囲（11:00 から 75:00）を表す必要があります。

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