コンテンツにスキップ

トレーニング時のカロリー燃焼推定API

トレーニングセッションの推定カロリー燃焼範囲と信頼度診断を返します。

エンドポイント

  • GET /api/v1/fitness/workout-calorie-estimate
  • POST /api/v1/fitness/workout-calorie-estimate/post

パラメータ

名前 タイプ 必須 クエリ/ボディ 説明
activity_type 文字列 はい クエリ/ボディ walking,jogging,running,cycling,swimming,strength_training,hiit,yoga,rowing,elliptical
duration_min 整数 (1-360) はい クエリ/ボディ セッションの持続時間 (分)。
weight 数値 (35-300) はい クエリ/ボディ 体重 (kg)。
intensity 文字列 はい クエリ/ボディ low,moderate,high,very_high
lang 文字列 いいえ クエリ レスポンス言語 (en,es,de,fr,pt,ja,hi,ar)

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

  • 単一の推定値ではなく、より現実的な燃焼範囲を提供します。
  • 信頼性と不確実性を説明することで、ユーザーの信頼を高めます。
  • より長期的な推定の品質を向上させるためのキャリブレーションルールを追加します。

始めましょう

リクエストの例

curl -X GET "https://api.hefitapi.com/api/v1/fitness/workout-calorie-estimate?activity_type=cycling&duration_min=55&weight=78&intensity=moderate&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/workout-calorie-estimate/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"activity_type":"hiit","duration_min":35,"weight":82,"intensity":"high"}'

レスポンスの例

Info

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

{
  "activity_type": "cycling",
  "activity_label": "Cycling",
  "duration_min": 55,
  "weight_kg": 78.0,
  "intensity": "moderate",
  "intensity_label": "Moderate",
  "estimated_calorie_burn": {"central_kcal": 562, "lower_kcal": 471, "upper_kcal": 653},
  "confidence": {
    "score": 84,
    "level": "medium",
    "level_label": "Medium",
    "notes": ["Moderate confidence for this activity profile"]
  },
  "fueling_guidance": ["Use balanced pre/post fueling around session length"],
  "calibration_protocol": ["Calibrate estimate with wearable and trend data"],
  "range_application_rules": ["Use lower bound for conservative planning"],
  "quality_checks": [],
  "summary": "Useful directional burn estimate with medium confidence.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "4b16430a6aa5df6a", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_workout_calorie_estimate", "response_language": "en"}
}

製品ポジショニング

フィットネス追跡アプリ、コーチングツール、およびウェアラブル連携分析製品に最適です。

注意

duration_min は 1 と 360 の範囲でなければなりません。

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