商品列表接口

基本信息

• 接口名称：商品列表
• 接口用途：查询统一商品列表，可同时包含积分商品与周边商品
• 调用方：小程序前端
• 请求方式：GET
• 请求路径：/goods
• 请求头要求：无

请求参数

参数	类型	必填	说明
channel	string	否	points / merch / all；不传等同 all
keyword	string	否	搜索词
sortType	string	否	排序类型
pageNo	int	否	页码
pageSize	int	否	每页条数

返回参数

参数	类型	说明
list	array	商品列表
hasMore	bool	是否还有更多

成功响应示例

{"code":"0","message":"ok","data":{"list":[{"goodsId":"g_1","title":"西湖明信片"}],"hasMore":true}}

失败响应示例

错误码

错误码	说明
A0003	商品查询参数错误

接口约束

• 幂等要求：否
• 前后端同步规则：切换筛选条件时需重置分页
• 缓存/刷新策略：列表缓存 60 秒
• 一致性要求：最终一致

说明

该接口用于统一返回商品列表，支持按商品渠道、关键词、排序方式进行查询，并通过分页参数控制结果集范围。