UapiProUApiPro
Food

食材营养详情

0次调用
3 积分/次

按食材名称或编码查询完整的营养档案。

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

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

code
string

食材编码，来自食材搜索接口。提供时优先使用。

返回内容涵盖

  • 核心营养：热量（大卡/千焦）、蛋白质、脂肪、碳水化合物、膳食纤维、钠含量。
  • 血糖指标 (gi / gl)：升糖指数与血糖负荷，适合糖尿病饮食管理场景。
  • 健康红绿灯与评价 (health_light / appraise)：食用建议。
  • 度量单位 (units)："1 颗 ≈ 89 克 ≈ 12 大卡"这类常用单位换算，厨房场景直接可用。

参数说明

code 与 name 二选一。推荐先用食材搜索接口拿到 code 再查详情；直接传 name 时会自动取搜索最匹配的第一条。

查询参数

name
string可选

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

code
string可选

食材编码，来自食材搜索接口。提供时优先使用。

响应

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": "查询服务暂时不可用，请稍后重试"
}
上一篇食材搜索
下一篇菜谱搜索