获取商品列表

接口调用请求说明

http请求方式:POST
https://api.weixin.qq.com/shop/spu/get_list?access_token=xxxxxxxxx

请求参数示例

{
    "status": 5,
    "page": 1,
    "page_size": 10,
    "need_edit_spu": 1      // 默认0:获取线上数据, 1:获取草稿数据
}

回包示例

{
    "errcode": 0,
    "errmsg":"ok",
    "total_num": 20,
    "spus":
    [
        {
            "out_product_id": "1234566",
            "title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
            "path": "plugin-private://wx34345ae5855f892d/pages/productDetail/productDetail?productId=2176180",
            "head_img": 
            [
                "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
            ],
            "desc_info": 
            {
                "desc": "xxxxx",
                "imgs": 
                [
                    "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
                ]
            },
            "third_cat_id": 6666,
            "brand_id": 2100000000,
            "skus":
            [
                {
                    "out_product_id": "1234566",
                    "out_sku_id": "1024",
                    "thumb_img": "http://img10.360buyimg.com/n1/s450x450_jfs/t1/100778/17/13648/424215/5e590a40E2d68e774/e171d222a0c9b763.jpg",
                    "sale_price": 1300,
                    "market_price": 1500,
                    "stock_num": 100,
                    "sku_code": "A24525252",
                    "barcode": "13251454",
                    "sku_attrs": 
                    [
                        {
                            "attr_key": "选择颜色",
                            "attr_value": "红蓝主机"
                        },
                        {
                            "attr_key": "选择套装",
                            "attr_value": "主机+保护套"
                        }
                    ]
                }
            ] 
        },
        ...
    ]
}

请求参数说明

参数 类型 是否必填 说明
out_product_id string 商家自定义商品ID,与product_id二选一
product_id number 交易组件平台内部商品ID,与out_product_id二选一
need_edit_spu number 默认0:获取线上数据, 1:获取草稿数据

回包参数说明

参数 类型 说明
errcode number 错误码
errmsg string 错误信息
total_num number 总数
spus[] object array spu数组
spus[].product_id number 交易组件平台内部商品ID
spus[].out_product_id string 商家自定义商品ID
spus[].title string 标题
spus[].path string 绑定的小程序商品路径
spus[].head_img string array 主图,多张,列表
spus[].desc_info.desc string 商品详情图文
spus[].desc_info.imgs string array 商品详情图片
spus[].status number 商品线上状态
spus[].edit_status number 商品草稿状态
spus[].third_cat_id number 第三级类目ID
spus[].brand_id number 品牌id
spus[].skus[] object array sku数组
spus[].skus[].out_product_id string 商家自定义商品ID
spus[].skus[].out_sku_id string 商家自定义skuID
spus[].skus[].thumb_img string sku小图
spus[].skus[].sale_price number 售卖价格,以分为单位
spus[].skus[].market_price number 市场价格,以分为单位
spus[].skus[].stock_num number 库存
spus[].skus[].barcode string 条形码
spus[].skus[].sku_code string 商品编码
spus[].skus[].sku_attrs[].attr_key string 销售属性key(自定义)
spus[].skus[].sku_attrs[].attr_value string 销售属性value(自定义)

枚举-edit_status

枚举值 描述
0 初始值
1 编辑中
2 审核中
3 审核失败
4 审核成功

枚举-status

枚举值 描述
0 初始值
5 上架
9 逻辑删除
11 自主下架
12 售磬下架
13 违规下架/风控系统下架

返回码

返回码 错误类型
-1 系统异常
-2 token太长
9401020 参数有误
9401021 无权限调用该api
9401002 SPU不存在
9401001 SPU已经存在
9401023 SPU不允许编辑