コンテンツにスキップ

Karvonen API

心拍数に基づいた、運動セッションにおける精密な目標心拍数ガイダンスを提供します。

エンドポイント

  • GET /api/v1/karvonen
  • POST /api/v1/karvonen/post

パラメータ

名前 タイプ 必須 パラメータ 説明
age 整数 (0より大きい) はい クエリ/ボディ 年齢 (年単位)。
rhr 整数 (0より大きい) はい クエリ/ボディ 静止時の心拍数 (bpm)。
intensity 数値 (10-100) はい クエリ/ボディ 目標運動強度 (パーセント)。
mhr 整数 (0より大きい) いいえ クエリ/ボディ 最大心拍数。指定しない場合、APIは 220 - age を使用します。
lang 文字列 いいえ クエリ レスポンス言語 (en, es, de, fr, pt, ja, hi, ar)。

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

  • 一般的なゾーンではなく、心拍数に基づいた目標を設定します。
  • 回復、有酸素運動、閾値、HIITセッションに適したセッション設計を調整します。
  • 消費者向けカーディオアプリに、透明な目標ゾーン計算機能を組み込みます。

始める

リクエスト例

curl -X GET "https://api.hefitapi.com/api/v1/karvonen?age=35&rhr=58&intensity=72&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/karvonen/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":35,"rhr":58,"mhr":188,"intensity":78}'

レスポンス例

Info

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

{
  "age": 35,
  "resting_heart_rate_bpm": 58,
  "maximum_heart_rate_bpm": 185,
  "used_default_max_hr": true,
  "heart_rate_reserve_bpm": 127,
  "intensity_percent": 72.0,
  "target_heart_rate_bpm": 149.44,
  "training_zone_range_bpm": {
    "min": 143.09,
    "max": 155.79
  },
  "intensity_band": "aerobic",
  "intensity_band_label": "Aerobic",
  "risk_signal": "Sustainable zone for base-building sessions.",
  "action_plan": ["Use longer steady-state intervals"],
  "monitoring_plan": "Track drift and perceived exertion each session.",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "dd67b47d2223915c",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "karvonen",
    "response_language": "en"
  }
}

製品のポジショニング

、耐性トレーニングアプリ、コーチングダッシュボード、および、繰り返し目標心拍数を自動化する必要があるジムプラットフォームに適しています。

注意

mhr が指定されていない場合、最大心拍数は 220 - age にデフォルトされます。

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