# 获取商品列表
# 接口说明
可通过该接口获取视频号小店的商品列表
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/product/list/get?access_token=ACCESS_TOKEN
# 请求参数说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
status | number | 否 | 商品状态,不填默认拉全部商品(不包含回收站),具体枚举值请参考status枚举 |
page_size | number | 是 | 每页数量(默认10,不超过30) |
next_key | string | 否 | 由上次请求返回,记录翻页的上下文。传入时会从上次返回的结果往后翻一页,不传默认获取第一页数据。 |
# 请求参数示例
{
"status": 5,
"page_size": 10,
"next_key": "THE_NEXT_KEY"
}
# 返回参数说明
参数 | 类型 | 描述 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
product_ids[] | string(uint64) array | 商品id列表 |
next_key | string | 本次翻页的上下文,用于请求下一页 |
total_num | number | 商品总数 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"product_ids": [
"1234567001",
"1234567002",
"1234567003",
"1234567004",
"1234567005",
"1234567006",
"1234567007",
"1234567008",
"1234567009",
"1234567010"
],
"next_key": "THE_NEXT_KEY_NEW",
"total_num": 100
}
# 错误码
错误码 | 错误描述 |
---|---|
公共错误码 | - |
10020050 | 无权限调用该api,请开发者获取权限后再试 |
10020051 | 参数有误,请开发者按照文档传参 |
# 枚举值
# status
商品状态
枚举值 | 描述 |
---|---|
0 | 初始值 |
5 | 获取上架商品 |
6 | 回收站(只有当传入status==6才会返回回收站中的商品,其他情况不返回) |
11 | 获取所有下架商品(包含自主下架和违规下架),对应枚举值为11、13、14、15、20,具体含义请查看获取商品接口中的商品状态字段说明 |