H5好物推荐JSAPI

2019年7月5日11:35:17 发表评论 424 views

公众号H5开发者可通过微信JS-SDK的openBusinessView接口,将物品推荐好物圈

特别注意:微信JS-SDK需更新为1.5版本

wx.openBusinessView接口

接口调用方法

调用openBusinessView接口前,判断当前用户的微信是否支持(iOS微信7.0.3及以上版本支持,安卓微信7.0.4及以上版本支持),另外小程序内嵌webview也可调用此API

wx.openBusinessView({
  businessType: 'friendGoodsRecommend',
  queryString: '',
  success: function (res) {
  //{"err_msg":"errmsg","extraData":{}}
  },
  fail: function (res){
  //{"err_msg":"errmsg"}
  }
})

接口参数说明

属性 类型 必填 说明
businessType String 固定值 friendGoodsRecommend
queryString String 公众号身份及物品信息,详见下文解释
success Function 接口回调,回调参数详见下文
fail Function 接口回调,回调参数详见下文

queryString示例

jsCheck=${encodeURIComponent(JSON.stringfy(jsCheckObject))}&product=${encodeURIComponent(JSON.stringfy(productObject))}}

jsCheckObject示例

{
  "appid": "",
  "timestamp": 0,
  "noncestr": "",
  "signature": "",
  "url": ""
}

jsCheckObject字段说明

属性 类型 必填 说明
appid String 公众号的唯一标识,对应wx.config()的appid参数
timestamp Number 生成签名的时间戳,对应wx.config()timestamp参数
noncestr String 生成签名的随机串,对应wx.config()的noncestr参数
signature String 签名,对应wx.config()的signature参数
url String 当前页面的完整url除去'#'部分

productObject示例

{
  "item_code": "00003563372839_00000010154601",
  "title": "product_name",
  "desc": "product_description",
  "category_list": ["服装", "上衣", "短袖衬衫"],
  "image_list": ["https://res.wx.qq.com/mpres/htmledition/images/xxxx.jpeg"],
  "src_h5_path": "https://...",
  "sku_list": [{
    "sku_id": "1234567",
    "price": 24000,
    "original_price": 30000,
    "poi_list": [
      {
        "longitude": 116.32676,
        "latitude": 40.003305,
        "radius": 4,
        "business_name": "肯德基",
        "branch_name": "珠江新城店",
        "address": "新港中路123号"
      }
    ],
    "status": 1,
    "sku_attr_list": [
      { "name": "颜色", "value": "白色" },
      { "name": "尺码", "value": "XXL" },
    ]
  }],
  "brand_info": {
    "name": "westore官方店",
    "icon": "logourl",
    "phone": "phonenum"
  }
}

productObject字段说明

属性 类型 必填 说明
item_code String 物品的唯一标识
title String 物品的名称
desc String 物品描述
category_list String Array 类目列表
image_list String Array 物品高清图片url列表, 要求图片宽度大于750px,宽高比在4:3 - 1:1之间
src_h5_path String 物品的H5落地页url
brand_info Object 物品所属店铺信息,非平台型商家选填,具体见brand_info字段说明
sku_list Object Array 物品SKU列表,具体见sku_list字段说明

brand_info字段说明

属性 类型 必填 描述
name String 商家名字
logo String 商家logo
phone String 商家电话

sku_list字段说明

属性 类型 必填 描述
sku_id String 商品的sku_id,需保证同个item_code下唯一
price Number 单位为  的物品现价。大于等于0的整数
original_price Number 单位为  的物品原价。大于等于0的整数
status Number 物品状态。数字枚举值:1:在售; 2:下架; 3:售罄
poi_list Object Array 门店的poi信息,具体见poi_list字段说明
sku_attr_list Object Array 物品属性列表,具体见sku_attr_list字段说明

sku_attr_list字段说明

属性 类型 必填 描述
name String 物品属性值名
value String 物品属性值

poi_list字段说明

属性 类型 必填 描述
longitude Number 门店的经度,WGS84标准
latitude Number 门店的纬度,WGS84标准
radius Number 门店可送达半径,单位km
business_name String 门店名称(仅为商户名,如:国美、麦当劳,不应包含地区、地址、分店名等信息,错误示例:北京国美),20个字符以内
branch_name String 分店名称(不应包含地区信息,不应与门店名有重复,错误示例:北京王府井店),20个字符以内
address String 门店地址(不包含省市区信息,如:新港中路123号)

sku_attr_list字段说明

属性 类型 必填 描述
name String 物品属性值名
value String 物品属性值

接口回调说明

参数名 类型 说明
errCode Number 错误码
errMsg String 调用结果
extraData Object success回调时可能不为空

接口错误类型

errCode errMsg 说明
0 success回调: ok 用户点击左上角或点完成按钮返回
-1 fail回调: fail system error 未知错误
-2 fail回调: fail request CGI error CGI 失败
-3 fail回调: fail cancel 用户右滑返回或验证appid失败返回
-5 fail回调: fail parmameter error 参数错误
weinxin
好物圈抱团交流QQ群
群号:868224432

发表评论

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen: