文档

测试

商品列表

websocket测试

POST

goods/list

接口描述

获取商品列表

请求参数

application/x-www-form-urlencoded

参数名

类型

描述

必填

cid

int

二级分类ID

可选

scid

int

商家分类ID

可选

query

str

搜索关键词

可选

filters

str

JSON编码的筛选数据字符串，具体参考筛选规则

可选

gids

str

逗号分隔的商品ID，如101,102,302,66

可选

status

int

状态

可选

响应参数

参数名

类型

描述

必填

code

int

错误码，0正确，大于0表示有错误

必填

msg

str

错误信息，ok 或错误信息

必填

data

obj

返回的数据

必填

list

array

列表

必填

total

int

总数

必填

说明 / 示例

>i [**商品筛选规则**](doc:vgPT4GuJ) [商品成新度](doc:wUVeTctY) ## 返回示例 ```json { "code": 0, "msg": "ok", "data": { "list": [ { "quality": "6", //成新度 "gid": "2", //商品ID "priceMin": "38.80", //每日起租价 "startDays": "60", //起租天数 "name": "iPhone 12", //商品名称 "cover": "https://yiqizu-production.oss-accelerate.aliyuncs.com/phone.jpg?x-oss-process=image/resize,w_300/quality,q_90", //商品封面 "canBuy": "1", //是否可买断 "safe": "1", //是否放心租 "tags": [ //商品标签 "99新", "性价比" ] }, { "gid": "1", "priceMin": "36.80", "startDays": "30", "name": "iPhone 12", "cover": "https://yiqizu-production.oss-accelerate.aliyuncs.com/phone.jpg?x-oss-process=image/resize,w_300/quality,q_90", "canBuy": "1", "safe": "1", "tags": [ "99新", "性价比" ] } ], "total": 2 } } ```

上一篇筛选规则

nextDoc 商品详情