UapiProUApiPro
食物

食材营养详情

0次调用
3 积分/次

想要精确计算一顿健身餐的碳水和蛋白质？或者为用户提供 GI/GL 升糖指数参考？这个接口能为你提供最详尽的食材营养档案。

GET
uapis.cn
/api/v1/food/ingredient/detail
查询参数
2
name
string

食材名称，如：小白菜。与 code 参数二选一。

code
string

食材独有编码。与 name 参数二选一。

返回内容涵盖

  • 核心营养素：热量（大卡/千焦）、蛋白质、脂肪、碳水化合物、膳食纤维、钠含量。
  • 血糖指标：升糖指数 (gi) 与血糖负荷 (gl)，非常适合糖尿病饮食管理或低 GI 饮食场景。
  • 饮食评价：具体的食用健康建议（如“推荐食用”）。
  • 度量单位换算 (units)：提供类似“1 颗 ≈ 89 克 ≈ 12 大卡”的日常单位换算，解决用户“没带厨房秤”的痛点。

查询方式二选一

接口支持传入 name (食材名称) 或 code (食材编码)。如果直接传入 name，系统会自动获取搜索匹配度最高的第一条数据；如果想确保 100% 精确，建议先调用「食材搜索」接口拿到 code 后再传入。

查询参数

name
string可选

食材名称，如：小白菜。与 code 参数二选一。

code
string可选

食材独有编码。与 name 参数二选一。

响应

200 / 请求成功

查询成功，返回该食材的完整营养成分与换算档案。

JSON
{
  "code": "xiaobaicai",
  "name": "小白菜",
  // 每 100 克热量（大卡）
  "calory": "14",
  // 每 100 克热量（千焦）
  "calory_kj": "59",
  "weight": "100",
  "health_light": 1,
  "is_liquid": false,
  "thumb_image_url": "string",
  "large_image_url": "string",
  // 蛋白质（克/100克）
  "protein": "1.5",
  // 脂肪（克/100克）
  "fat": "0.3",
  // 膳食纤维（克/100克）
  "fiber_dietary": "1.1",
  // 碳水化合物（克/100克）
  "carbohydrate": "2.4",
  // 钠含量（毫克/100克）
  "natrium": "73",
  // 升糖指数
  "gi": "15",
  // 血糖负荷
  "gl": "0.4",
  "appraise": "推荐食用",
  "units": [
    {
      "amount": "1",
      "unit": "颗",
      // 该单位对应克重
      "weight": "89",
      // 该单位对应热量
      "calory": "12"
    }
  ]
}

400 / 错误的请求

参数缺失，name 和 code 必须至少提供一个。

JSON
{
  "code": "INVALID_PARAMETER",
  "message": "name 和 code 至少提供一个"
}

404 / 未找到

没有找到该食材的营养数据。

JSON
{
  "code": "NO_MATCH",
  "message": "没有找到相关结果: xxx"
}

502 / 网关错误

服务暂时不可用，请稍后重试。

JSON
{
  "code": "SERVICE_UNAVAILABLE",
  "message": "服务暂时不可用，请稍后重试"
}
上一篇食材搜索
下一篇菜谱搜索