查询物品信息
开发者可以对导入到微信圈子中的物品信息进行查询,接口说明如下:
请求数据样例
{
"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 | 成功 |
| 其他常见错误码 | 点击查看 |