智能小程序 Ray 开发菜谱 API ——食谱列表及详情 API 接口汇总（二）

获取食谱详情

getRecipeDetail

引入

@ray-js/ray^1.5.0 以上版本可使用

import { getRecipeDetail } from '@ray-js/ray'

参数

RecipeDetailParams 对象，包含以下属性：

属性	类型	默认值	必填	说明
menuId	number		是	食谱 ID
devId	string		是	设备 ID

getRecipeList 返回结果

RecipeListResponse 对象，包含以下属性：

属性	类型	说明
totalCount	number	总记录数
pageNo	number	当前页码
pageSize	number	每页记录数
hasNext	boolean	是否有下一页
data	RecipeInfo[]	食谱信息数组

RecipeInfo 对象，包含以下属性：

属性	类型	说明
id	number	食谱 ID
mainImgs	string[]	主图数组
lang	number	语言类型
langDesc	string	语言描述
desc	string	描述
cookType	number	烹饪方式
sourceType	number	来源类型
isMainShow	number	是否主显示
isShowControl	number	是否显示控制
isControl	number	是否受控
name	string	名称
easyLevel	string	难易等级
easyLevelDesc	string	难易等级描述
taste	string	口味
tasteDesc	string	口味描述
foodType	string	食品类型
foodTypeDesc	string	食品类型描述
cookTime	number	烹饪时间
eatCount	number	用餐人数
avgScore	number	平均评分
isStar	boolean	是否加星
gmtCreate	number	创建时间
gmtModified	number	修改时间

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。   

返回结果 RecipeDetailResponse

属性	类型	说明
id	number	食谱 ID
name	string	名称
desc	string	描述
information	string	信息
xyxk	string	食谱相关信息
foods	string	食材
mainImgs	string[]	主图数组
origMainImgs	string[]	原始主图数组
lang	number	语言类型
langDesc	string	语言描述
preVideo	string	准备视频
stepVideo	string	步骤视频
isMainShow	number	是否主显示
isControl	number	是否受控
isShowControl	number	是否显示控制
sourceType	number	来源类型
cookType	number	烹饪方式
extInfo	string	扩展信息
cookTime	number	烹饪时间
useFoodLib	number	使用食材库
eatCount	number	用餐人数
isFoodChannel	number	是否为食品频道
easyLevel	string	难易等级
easyLevelDesc	string	难易等级描述
taste	string	口味
tasteDesc	string	口味描述
foodType	string	食品类型
foodTypeDesc	string	食品类型描述
allergens	AllergenInfo[]	过敏原信息数组
author	string	作者
pv	number	浏览量
avgScore	number	平均评分
menuStepInfoVOList	MenuStepInfoVO[]	图文步骤信息数组
cookStepInfoVOList	CookStepInfoVO[]	烹饪步骤信息数组
foodInfoVOList	FoodInfoVO[]	食材信息数组
customInfoList	CustomInfo[]	自定义属性信息数组
likes	number	点赞次数 @ray-js/ray^1.5.5新增
isLike	boolean	是否点赞 @ray-js/ray^1.5.5新增
gmtCreate	number	创建时间
gmtModified	number	修改时间

AllergenInfo

属性	类型	说明
id	number	过敏原 ID
name	string	过敏原名称

LangInfo

属性	类型	说明
lang	string	语言标识
stepImg	string	步骤图片（可选）
origStepImg	string	原始步骤图片（可选）
desc	string	描述

MenuStepInfoVO

属性	类型	说明
id	number	步骤 ID
menuId	number	菜单 ID
step	number	步骤编号
langInfos	LangInfo[]	多语言信息数组
gmtCreate	number	创建时间
gmtModified	number	修改时间

CookStepInfoVO

属性	类型	说明
id	number	步骤 ID
menuId	number	菜单 ID
isCookArgs	number	是否为烹饪参数
step	number	步骤编号
stepImg	string	步骤图片（可选）
origStepImg	string	原始步骤图片（可选）
finishCtrl	string	完成控制（可选）
cookArgs	any[]	烹饪参数（可选）
langInfos	LangInfo[]	多语言信息数组
gmtCreate	number	创建时间
gmtModified	number	修改时间

FoodInfoVO

属性	类型	说明
id	number	食材 ID
name	string	食材名称
lang	string	语言标识
image	string	食材图片
desc	string	食材描述
menuFoodRelationVO	any	菜单食材关系对象
foodNutritionVOList	any[]	食材营养信息数组
gmtCreate	number	创建时间
gmtModified	number	修改时间

CustomLangInfo

属性	类型	说明
lang	string	语言标识
name	string	名称
desc	string	描述
fileUrl	string	文件 URL
origFileUrl	string	自定义食谱才会有

CustomInfo

属性	类型	说明
code	string	自定义属性编码
fileUrl	string	自定义属性文件 URL
langInfos	CustomLangInfo[]	多语言信息数组

函数定义示例

/**
 * 获取食谱详情
 * @param {RecipeDetailParams} params - 包含食谱 ID 和设备 ID 的对象
 * @returns {Promise<RecipeDetailResponse>} - 返回食谱详情响应的 Promise
 */
export function getRecipeDetail(params: RecipeDetailParams): Promise<RecipeDetailResponse>

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。