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