Food

菜谱详情

0次调用
3 积分/次

按菜谱搜索接口返回的 ID 查询完整菜谱。

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

菜谱 ID(带源前缀),来自菜谱搜索接口返回的 id 字段。

返回内容涵盖

  • 食材清单 (ingredients):如"鸡蛋 4个""番茄 3个",含用量。
  • 图文步骤 (steps):每一步的文字说明和配图,按顺序排列。
  • 附加信息:作者、综合评分、分类、封面图。

参数说明

id 必须带数据源前缀(xcf:dg:),直接复用搜索接口返回的 id 字段即可,不要手动拼接或修改。

查询参数

id
string必填

菜谱 ID(带源前缀),来自菜谱搜索接口返回的 id 字段。

响应

200 / 请求成功

查询成功,返回完整菜谱。

JSON
{
  "id": "xcf:104493058",
  "title": "超嫩滑的番茄炒蛋",
  "cover": "string",
  "url": "string",
  "source": "xcf",
  "author": "cheese喵喵喵喵喵",
  "description": "一道看似很简单的菜式……",
  "category": "家常菜",
  // 综合评分(满分 10)
  "rating": "8.0",
  "ingredients": [
    "鸡蛋 4个"
  ],
  "steps": [
    {
      "step": 1,
      "text": "加 1 小勺盐融于少量温水中",
      // 步骤配图,可能为空
      "image": "string"
    }
  ]
}

400 / 错误的请求

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

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

404 / 未找到

菜谱不存在或 ID 前缀无法识别。

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

502 / 网关错误

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

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