コンテンツにスキップ

VO2max 推定 API

フィールドテストのパフォーマンスと安静時の生理に基づいて、心肺機能のプロファイルを構築します。

エンドポイント

  • GET /api/v1/fitness/vo2max-estimate
  • POST /api/v1/fitness/vo2max-estimate/post

パラメータ

名前 型 必須 In 説明
age 整数 (13-85) はい クエリ/ボディ 年齢 (年単位)。
gender 文字列 はい クエリ/ボディ male または female。
resting_hr 数値 (30-130) はい クエリ/ボディ 静止時の心拍数 (bpm)。
cooper_test_distance 数値 (800-5000) 条件付き クエリ/ボディ 12分間のクーパー距離 (メートル)。
1_5_mile_time 数値 (6-30) 条件付き クエリ/ボディ 1.5マイルのランタイム (分)。
lang 文字列 いいえ クエリ レスポンス言語 (en, es, de, fr, pt, ja, hi, ar)。

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

  • 1つのレスポンスで複数のVO2推定方法を組み合わせる。
  • 分類、パーセンタイル、およびトレーニングの焦点を当てるガイダンスを追加する。
  • フィットネス年齢とリスクに関する洞察機能のサポート。

始める

リクエストの例

curl -X GET "https://api.hefitapi.com/api/v1/fitness/vo2max-estimate?age=33&gender=male&resting_hr=56&cooper_test_distance=2800&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/vo2max-estimate/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":29,"gender":"female","resting_hr":60,"1_5_mile_time":11.8}'

レスポンスの例

Info

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

{
  "age": 33,
  "gender": "male",
  "resting_hr_bpm": 56.0,
  "test_inputs": {"cooper_test_distance_m": 2800.0, "run_1_5_mile_time_min": null},
  "estimate_method": "cooper_blend",
  "estimate_method_label": "Cooper Blend",
  "vo2max_estimate_ml_kg_min": 51.2,
  "vo2max_range_ml_kg_min": {"lower": 45.1, "upper": 57.3},
  "fitness_classification": "excellent",
  "fitness_classification_label": "Excellent",
  "percentile_estimate": 87,
  "confidence": {"score": 84, "level": "medium", "level_label": "Medium", "notes": "Single-test blend provides solid directional estimate."},
  "cardiorespiratory_risk_insight": "Favorable cardiorespiratory profile.",
  "training_focus_recommendations": ["Maintain aerobic base and threshold progressions"],
  "derived_metrics": {"estimated_hr_max_bpm": 185, "hr_reserve_bpm": 129, "fitness_age_estimate_years": 28},
  "summary": "Excellent aerobic profile with strong performance potential.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "31a83dfecbe5a34b", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_vo2max_estimate", "response_language": "en"}
}

製品ポジショニング

エンデュランスアプリ、ウェルネススコアリング、およびトレーニング診断プラットフォーム向けの高価値エンドポイント。

注意

少なくとも1つのフィールドテストの入力を提供してください: cooper_test_distance または 1_5_mile_time。

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