UapiProUApiPro
食物

菜谱详情

0次调用
3 积分/次

拿到菜谱 ID 后，如何展示一份保姆级的做菜教程？这个接口直接为你返回完整的图文步骤。

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

菜谱的唯一标识 ID。

返回内容涵盖

  • 食材用量清单 (ingredients)：精确到具体用量（如“鸡蛋 4个”、“生抽 1勺”），方便用户准备备菜。
  • 分步图文教程 (steps)：将每一步的文字说明与配图按操作顺序排好，便于前端做滑动播放或列表渲染。
  • 附加属性：菜谱分类、综合评分（满分10分）等周边信息。

参数说明

务必直接复用「菜谱搜索」接口返回的完整 id 字符串。不要对其进行截取或修改，否则可能导致无法识别。

查询参数

id
string必填

菜谱的唯一标识 ID。

响应

200 / 请求成功

查询成功，返回该菜谱的完整图文教程。

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

400 / 错误的请求

参数错误，请检查 id 是否为空或格式有误。

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

404 / 未找到

该菜谱不存在或已被下架。

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

502 / 网关错误

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

JSON
{
  "code": "SERVICE_UNAVAILABLE",
  "message": "服务暂时不可用，请稍后重试"
}
上一篇菜谱搜索