# 获取商品列表

# 接口说明

可通过该接口获取视频号小店的商品列表

# 接口调用请求说明

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,具体含义请查看获取商品接口中的商品状态字段说明