查询物品信息

开发者可以对导入到微信圈子中的物品信息进行查询,接口说明如下:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/queryproduct?access_token=ACCESS_TOKEN&type=batchquery
POST数据格式 UTF-8 json
接口能力 查询物品数据
接口调用时机 需要查询已导入微信圈子的物品数据时
type batchquery代表批量查询

请求数据样例

{
  "key_list":[
    {
      "item_code":"00003563372839_0000xxxxxxxx"
    }, {
      "item_code":"00003563372839_0000xxxxxxxx"
    }
  ]
}
接口基本字段 必填 字段类型 说明
key_list array 单次请求物品数量不可超过100个
key_list基本字段 必填 字段类型 说明
item_code string 物品item_code
物品基本字段 必填 字段类型 说明
product_list array 单次请求物品数量不可超过10个
product_list字段 必填 字段类型 说明
item_code string 物品ID(SPU ID),要求appid下全局唯一
title string 物品名称
desc string 物品描述
category_list string array 物品类目列表,用于搜索排序
image_list string array 物品图片链接列表
src_wxapp_path string 物品来源小程序路径
attr_list object array 物品SPU属性
sku_list object array 物品SKU列表,单次导入不超过16个SKU,微信后台会合并多次导入的SKU
version int 数据版本号,需按照更新递增,用在并发更新场景
version int 非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
can_be_search bool 物品能否被搜索(默认true可以被搜索)
brand_info object 商家信息
attr_list字段 必填 字段类型 说明
name string 属性名称
value string 属性内容
poi_list字段 选填 字段类型 说明
longitude double 门店的经度,WGS84标准
latitude double 门店的纬度,WGS84标准
radius double 门店可送达半径,单位km
business_name string 门店名称(仅为商户名,如:国美、麦当劳,不应包含地区、地址、分店名等信息,错误示例:北京国美),20个字符以内
branch_name string 分店名称(不应包含地区信息,不应与门店名有重复,错误示例:北京王府井店),20个字符以内
sku_list字段 必填 字段类型 说明
sku_id string 物品sku_id,特殊情况下可以填入与item_code一致
price int 物品价格,分为单位
original_price int 物品原价,分为单位
version int 数据版本号,需按照更新递增,用在并发更新场景
status int 物品状态,1:在售,2:停售
sku_attr_list object array sku属性列表,参考attr_list
poi_list object array 物品所在门店的列表。如果物品仅支持到店提货或到家送货,该字段必填;如果物品同时支持线上物流配送,该字段应为空。
brand_info字段 必填 字段类型 说明
logo string 商家logo
name string 商家名称

回包数据样例

接口调用成功回包
{
    "errcode": 0,
    "errmsg": "success",
    "product_list": [
        {
            "item_code": "00003563372839_00000xxxxxx",
            "sku_list": [
                {
                    "sku_id": "00003563372839_100xxxxxxx",
                    "sku_attr_list": [],
                    "price": 1,
                    "status": 1,
                    "poi_list": []
                }
            ],
            "title": "xxxxxxx",
            "desc": "",
            "image_list": [
                "https://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
            ],
            "attr_list": [],
            "category_list": [
                "面部护理套装"
            ],
            "src_wxapp_path": ""
        },
        {
            "item_code": "00003563xxxxxxxxxxxxxxxxxxxxxx",
            "sku_list": [
                {
                    "sku_id": "00003563372839_xxxxxxxxxxxxxxxxx",
                    "sku_attr_list": [
                        {
                            "name": "颜色",
                            "value": "红色"
                        },
                        {
                            "name": "手机型号",
                            "value": "iPhoneX"
                        }
                    ],
                    "price": 1,
                    "status": 1,
                    "poi_list": []
                }
            ],
            "title": "红包拿来手机壳套装",
            "desc": "红色 | iPhoneX",
            "image_list": [
                "https://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
            ],
            "attr_list": [
                {
                    "name": "手机型号",
                    "value": "iPhoneX"
                },
                {
                    "name": "颜色",
                    "value": "红色"
                }
            ],
            "category_list": [
                "面部护理套装"
            ],
            "src_wxapp_path": ""
        }
    ]
}

接口错误码

回包错误码 说明
0 成功
其他常见错误码 点击查看