Food

菜谱搜索

0次调用
1 积分/次

输入菜名(如"番茄炒蛋")或食材(如"鸡蛋"),返回匹配的菜谱列表。

GET
uapis.cn
/api/v1/food/recipe
查询参数
1
keyword
string
required

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

功能概述

每条结果包含菜谱标题、封面图和一个带源前缀的菜谱 ID(如 xcf:104493058)。这个 ID 原样传给菜谱详情接口即可拿到完整的食材清单和步骤图文。

使用须知

  • 支持用食材名称搜索,适合做"冰箱里剩什么就做什么"的功能。
  • 数据源会自动在主备之间切换,source 字段标识本条结果来自哪个数据源,调用方无需关心。
  • 没有找到时返回 404。

查询参数

keyword
string必填

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

响应

200 / 请求成功

搜索成功,返回菜谱列表。

JSON
{
  "keyword": "番茄炒蛋",
  "count": 20,
  "items": [
    {
      // 带源前缀的菜谱 ID,用于详情接口
      "id": "xcf:104493058",
      "title": "超嫩滑的番茄炒蛋",
      // 封面图
      "cover": "string",
      // 原始页面地址
      "url": "string",
      // 数据源标识
      "source": "xcf"
    }
  ]
}

400 / 错误的请求

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

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

404 / 未找到

没有找到匹配的菜谱。

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

502 / 网关错误

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

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