心拍数ゾーンAPI¶
脂肪燃焼、持久力、パフォーマンス最適化のための、具体的な指導文脈を含む心拍数ゾーンを返します。
エンドポイント¶
GET /api/v1/fitness/heart-rate-zonesPOST /api/v1/fitness/heart-rate-zones/post
パラメータ¶
| 名前 | タイプ | 必須 | In | 説明 |
|---|---|---|---|---|
age | 整数 (13-90) | はい | クエリ/ボディ | 選手の年齢 (年)。 |
resting_hr | 数値 (30-130) | はい | クエリ/ボディ | 静止心拍数 (bpm)。 |
goal | 文字列 | はい | クエリ/ボディ | fat_loss, muscle_gain, maintenance, endurance, recomposition。 |
max_hr | 数値 (120-230) | いいえ | クエリ/ボディ | 最大心拍数; 省略された場合は、年齢に基づく推定値を使用します。 |
lang | 文字列 | いいえ | クエリ | レスポンス言語 (en, es, de, fr, pt, ja, hi, ar)。 |
このエンドポイントを使用する理由¶
- ユーザープロファイルごとに、トレーニングに最適な心拍数ゾーンを配信します。
- セッションの指示を目標と準備状況に合わせて調整します。
- 一貫したゾーンロジックでコーチングの自動化をサポートします。
リクエストの例¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/heart-rate-zones?age=33&resting_hr=58&goal=endurance&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/heart-rate-zones/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"age":33,"resting_hr":58,"goal":"fat_loss","max_hr":188}'
レスポンスの例¶
Info
以下のレスポンスの例は、あくまでデモンストレーション用です。 このエンドポイントに対して実際にリクエストを行い、完全でリアルタイム、そしてより詳細なJSON構造を取得してください。
{
"goal": "fat_loss",
"goal_label": "Fat Loss",
"age": 33,
"resting_hr_bpm": 58.0,
"max_hr_bpm": 188,
"max_hr_source": "provided",
"heart_rate_reserve_bpm": 130,
"zones": {
"zone_1": {"label": "Zone 1", "min_bpm": 123, "max_bpm": 136},
"zone_2": {"label": "Zone 2", "min_bpm": 136, "max_bpm": 149},
"zone_3": {"label": "Zone 3", "min_bpm": 149, "max_bpm": 162},
"zone_4": {"label": "Zone 4", "min_bpm": 162, "max_bpm": 175},
"zone_5": {"label": "Zone 5", "min_bpm": 175, "max_bpm": 188}
},
"fat_burn_zone": {"zone": "zone_2", "label": "Fat Burn Zone", "min_bpm": 136, "max_bpm": 149},
"vo2_optimization_zone": {"zone": "zone_4", "label": "VO2 Optimization Zone", "min_bpm": 162, "max_bpm": 175},
"threshold_zone": {"zone": "zone_4", "min_bpm": 162, "max_bpm": 175},
"anaerobic_power_zone": {"zone": "zone_5", "min_bpm": 175, "max_bpm": 188},
"readiness_signal": {"level": "high", "level_label": "High", "note": "Recovery indicators support quality intervals."},
"goal_session_guidance": ["2 threshold intervals", "1 long zone-2 block"],
"training_notes": {
"warmup": "Build progressively for 10-15 minutes.",
"cooldown": "Use 8-10 minutes low-intensity recovery.",
"zone_switching": "Transition gradually when moving between zones."
},
"summary": "Balanced zone strategy optimized for fat-loss efficiency.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "f6b9fb31d4f2a027",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"endpoint_name": "fitness_heart_rate_zones",
"response_language": "en"
}
}
製品ポジショニング¶
接続型フィットネスウェア、コーチングダッシュボード、および持久力トレーニングの自動化に最適です。
注意
max_hr はオプションです。省略された場合、APIは年齢に基づいてTanakaの公式を使用して最大心拍数を推定します。
推奨されるエンドポイント¶
GET /api/v1/bmi- bmi APIGET /api/v1/tdee- tdee APIGET /api/v1/bmr- bmr APIGET /api/v1/protein-calculator- タンパク質計算機 APIGET /api/v1/bodyfat- 体組成 APIGET /api/v1/maintenance-calorie- メンテナンスカロリー API