コンテンツにスキップ

ミクロ栄養素 API

ライフステージに合わせたガイダンスを用いて、栄養名、年齢、性別ごとに、1日のミクロ栄養素の必要量を検索します。

エンドポイント

  • GET /api/v1/micronutrient
  • POST /api/v1/micronutrient/post

パラメータ

名前 タイプ 必須 In 説明
gender 文字列 はい クエリ/ボディ male または female。
age 整数 はい クエリ/ボディ 年齢（歳単位）；9歳以上の年齢グループをサポート。
micronutrient 文字列 はい クエリ/ボディ 栄養素のキー (calcium、iron、magnesium、b12に関連するキーなど）。
lang 文字列 いいえ クエリ レスポンス言語 (en、es、de、fr、pt、ja、hi、ar）。

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

  • 栄養製品の必要量検索を一元化します。
  • UXフローにおける、年齢グループに特化した推奨事項をサポートします。
  • 各検索で、ライフステージに合わせた具体的なガイダンスを返します。

始める

リクエストの例

curl -X GET "https://api.hefitapi.com/api/v1/micronutrient?gender=female&age=29&micronutrient=iron&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/micronutrient/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"gender":"male","age":55,"micronutrient":"magnesium"}'

レスポンスの例

Info

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

{
  "Micronutrient": "iron",
  "Requirement": "18 mg/d",
  "requirement_value": 18,
  "requirement_unit": "mg/d",
  "Gender": "female",
  "Age": "29 yr",
  "age_group": "19-30 y",
  "life_stage": "adult",
  "life_stage_label": "Adult",
  "priority_focus": ["Prioritize nutrient density and absorption quality"],
  "monitoring_plan": "Review dietary adequacy in periodic nutrition check-ins.",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "f9b92ab61182d57e",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "micronutrient",
    "response_language": "en"
  }
}

製品のポジショニング

栄養教育ポータル、食事プランニングシステム、および企業向け予防健康製品に適しています。

注意

サポートされている年齢範囲以下の年齢の場合、HTTP 400が返されます。なぜなら、その年齢グループに対する必要量が定義されていないからです。

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