查询物品信息

开发者可以对导入到好物圈中的物品信息进行查询，接口说明如下：

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

请求数据样例

  1. {
  2.   "key_list":[
  3.     {
  4.       "item_code":"00003563372839_0000xxxxxxxx"
  5.     }, {
  6.       "item_code":"00003563372839_0000xxxxxxxx"
  7.     }
  8.   ]
  9. }
接口基本字段必填字段类型说明
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 arraysku属性列表，参考attr_list
poi_list否object array物品所在门店的列表。如果物品仅支持到店提货或到家送货，该字段必填；如果物品同时支持线上物流配送，该字段应为空。
brand_info字段必填字段类型说明
logo否string商家logo
name否string商家名称

回包数据样例

接口调用成功回包
  1. {
  2.     "errcode": 0,
  3.     "errmsg": "success",
  4.     "product_list": [
  5.         {
  6.             "item_code": "00003563372839_00000xxxxxx",
  7.             "sku_list": [
  8.                 {
  9.                     "sku_id": "00003563372839_100xxxxxxx",
  10.                     "sku_attr_list": [],
  11.                     "price": 1,
  12.                     "status": 1,
  13.                     "poi_list": []
  14.                 }
  15.             ],
  16.             "title": "xxxxxxx",
  17.             "desc": "",
  18.             "image_list": [
  19.                 "https://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  20.             ],
  21.             "attr_list": [],
  22.             "category_list": [
  23.                 "面部护理套装"
  24.             ],
  25.             "src_wxapp_path": ""
  26.         },
  27.         {
  28.             "item_code": "00003563xxxxxxxxxxxxxxxxxxxxxx",
  29.             "sku_list": [
  30.                 {
  31.                     "sku_id": "00003563372839_xxxxxxxxxxxxxxxxx",
  32.                     "sku_attr_list": [
  33.                         {
  34.                             "name": "颜色",
  35.                             "value": "红色"
  36.                         },
  37.                         {
  38.                             "name": "手机型号",
  39.                             "value": "iPhoneX"
  40.                         }
  41.                     ],
  42.                     "price": 1,
  43.                     "status": 1,
  44.                     "poi_list": []
  45.                 }
  46.             ],
  47.             "title": "红包拿来手机壳套装",
  48.             "desc": "红色 | iPhoneX",
  49.             "image_list": [
  50.                 "https://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  51.             ],
  52.             "attr_list": [
  53.                 {
  54.                     "name": "手机型号",
  55.                     "value": "iPhoneX"
  56.                 },
  57.                 {
  58.                     "name": "颜色",
  59.                     "value": "红色"
  60.                 }
  61.             ],
  62.             "category_list": [
  63.                 "面部护理套装"
  64.             ],
  65.             "src_wxapp_path": ""
  66.         }
  67.     ]
  68. }

接口错误码

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