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

获取食谱列表

getRecipeList

引入

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

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

参数

GetRecipeListParams 对象，包含以下属性：

属性	类型	默认值	必填	说明
query	RecipeListQuery		是	食谱列表查询条件

RecipeListQuery 包含以下属性：

属性	类型	默认值	必填	说明
productId	string		是	产品 ID
name	string		否	食谱名称
categoryIds	number[]		否	分类 ID 数组
cookTimeMin	number		否	最小烹饪时间
cookTimeMax	number		否	最大烹饪时间
easyLevelIds	number[]		否	难易等级 ID 数组
foodTypeIds	number[]		否	食品类型 ID 数组
allergenIds	number[]		否	过敏原 ID 数组
isFoodChannel	number		否	是否为食品频道
orderType	number		否	排序类型
pvWeight	number		否	浏览量权重
starCountWeight	number		否	收藏数权重
avgScoreWeight	number		否	平均评分权重
customInfoQuery	CustomInfoQueryItem[]		否	自定义属性查询 @ray-js/ray^1.5.5 新增
pageNo	number		是	页码
pageSize	number		是	每页显示数量

CustomInfoQueryItem

属性	类型	默认值	必填	说明
code	string		是	自定义属性 code
langValue	string		是	自定义属性 value

返回结果 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	修改时间

函数定义示例

/**
 * 获取食谱列表
 * @param {GetRecipeListParams} params - 包含查询条件的对象
 * @returns {Promise<RecipeListResponse>} - 返回食谱列表响应的 Promise
 */
export function getRecipeList(params: GetRecipeListParams): Promise<RecipeListResponse>

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

食谱点赞

operateRecipeLike

引入

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

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

参数

OperateRecipeLikeParams 对象，包含以下属性：

属性	类型	默认值	必填	说明
like	RecipeLike		是	点赞信息

RecipeLike

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

OperateRecipeLikeResponse 返回结果

boolean

函数定义示例

/**
 * 食谱点赞
 * @param {OperateRecipeLikeParams} params - query: { menuId: number, devId: string}
 * @returns {Promise<OperateRecipeLikeResponse>} - 返回食谱点赞响应的 Promise<boolean>
 */
export function operateRecipeLike(
  params: OperateRecipeLikeParams
): Promise<OperateRecipeLikeResponse>

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