Food

食材搜索

0次调用
1 积分/次

输入一个食材关键词(比如"白菜"),返回匹配的食材列表。每条结果包含食材编码、每 100 克热量、健康红绿灯评级和缩略图。

GET
uapis.cn
/api/v1/food/ingredient
查询参数
2
keyword
string
required

食材关键词,长度不超过 64 个字符。

page
integer

页码,范围 1-100,默认 1。

功能概述

  • 食材编码 (code):食材的唯一标识,可直接传给食材详情接口获取完整营养数据。
  • 热量 (calory):每 100 克的热量(大卡)。
  • 健康红绿灯 (health_light):1 为绿灯(推荐食用),2 为黄灯(适量食用),3 为红灯(少量食用)。

使用须知

返回结果按相关度排序,第一页通常就包含你要找的食材。没有找到时返回 404。

查询参数

keyword
string必填

食材关键词,长度不超过 64 个字符。

page
integer可选

页码,范围 1-100,默认 1。

响应

200 / 请求成功

搜索成功,返回匹配的食材列表。

JSON
{
  "keyword": "白菜",
  "count": 10,
  "total_pages": 2,
  "items": [
    {
      // 食材编码,用于详情接口
      "code": "xiaobaicai",
      "name": "小白菜",
      // 每 100 克热量(大卡)
      "calory": "14",
      // 热量对应的克重基准
      "weight": "100",
      // 1 绿灯 / 2 黄灯 / 3 红灯
      "health_light": 1,
      "thumb_image_url": "string",
      // 每 100 克碳水化合物(克)
      "carbohydrate": 2.4
    }
  ]
}

400 / 错误的请求

参数错误,如 keyword 为空或超长。

JSON
{
  "code": "INVALID_PARAMETER",
  "message": "keyword 不能为空"
}

404 / 未找到

没有找到匹配的食材。

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

502 / 网关错误

数据服务暂时不可用,请稍后重试。

JSON
{
  "code": "SERVICE_UNAVAILABLE",
  "message": "查询服务暂时不可用,请稍后重试"
}