コンテンツにスキップ

炭水化物計算 API

性別、年齢、身体測定値、および活動に基づいたTDEEに基づいて、推奨される炭水化物摂取量を計算します。

エンドポイント

  • GET /api/v1/carbs-calculator
  • POST /api/v1/carbs-calculator/post

パラメータ

名前 型 必須 In 説明
sex 文字列 (male,female) はい クエリ/本文 生物学的性別。
age 数値 はい クエリ/本文 年単位の年齢。
height 数値 はい クエリ/本文 身長 (cm メトリック、in 帝国)。
weight 数値 はい クエリ/本文 体重 (kg メトリック、lb 帝国)。
unit 文字列 (metric,imperial) いいえ クエリ/本文 入力単位モード。 デフォルトは metric。
activity_level 文字列 はい クエリ/本文 sedentary、lightly_active、moderately_active、very_active、extra_active。
lang 文字列 いいえ クエリ レスポンス言語 (en、es、de、fr、pt、ja、hi、ar)。

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

  • プロファイルデータを具体的な炭水化物目標に変換します。
  • トレーニング日/休息日の炭水化物摂取量の分割を可能にします。
  • コーチングアプリでの栄養計画のパーソナライズを向上させます。

開始する

リクエストの例

curl -X GET "https://api.hefitapi.com/api/v1/carbs-calculator?sex=male&age=31&height=178&weight=82&unit=metric&activity_level=moderately_active&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/carbs-calculator/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sex":"male","age":31,"height":178,"weight":82,"unit":"metric","activity_level":"moderately_active"}'

レスポンスの例

Info

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

{
  "sex": "male",
  "age": 31.0,
  "height_cm": 178.0,
  "weight_kg": 82.0,
  "unit": "metric",
  "activity_level": "moderately_active",
  "tdee_kcal_per_day": 2870.16,
  "usda_carbs_grams_range": [322.89, 466.4],
  "recommended_carbs_g": 394.65,
  "carb_band": "high",
  "carb_band_label": "High",
  "periodization_targets_g": {
    "rest_day": 355.19,
    "training_day": 434.12
  },
  "timing_guidance": ["Place larger carb portions around training"],
  "action_plan": ["Prioritize complex carbs", "Track response weekly"],
  "adjustment_rules": ["Reduce carbs if fat gain accelerates"],
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "2c8d9bd88b6f2f19",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "carbs_calculator",
    "response_language": "en"
  }
}

製品の価値

マクロ計画SaaS、栄養自動化ツール、およびパフォーマンスコーチング製品に適しています。

注意

activity_level は、サポートされているenum値と完全に一致する必要があります。

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