食物

菜谱搜索

0次调用
1 积分/次

不知道今晚吃什么?或者想做一个“冰箱里剩什么就查什么”的智能助手?只需输入菜名或任意几样食材,接口就能返回海量的匹配菜谱。

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

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

功能概述

搜索结果会返回菜谱的标题、精美封面图以及一个十分重要的 id 字段。这个 id 是一串特殊的标识符,你不需要关心它的组成规则,只需将它原封不动地传给「菜谱详情」接口,就能调出对应菜谱的详细图文教程。

查询参数

keyword
string必填

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

响应

200 / 请求成功

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

JSON
{
  "keyword": "番茄炒蛋",
  "count": 20,
  "items": [
    {
      // 菜谱唯一 ID,请原样传给详情接口
      "id": "xcf:104493058",
      "title": "超嫩滑的番茄炒蛋",
      // 封面图
      "cover": "string"
    }
  ]
}

400 / 错误的请求

参数错误,请检查 keyword 是否为空或超出长度限制。

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

404 / 未找到

没有找到匹配的菜谱。

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

502 / 网关错误

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

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