H5好物推荐JSAPI

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

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

wx.openBusinessView接口

接口调用方法

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

接口参数说明

属性类型必填说明
businessTypeString固定值 friendGoodsRecommend
queryStringString公众号身份及物品信息,详见下文解释
successFunction接口回调,回调参数详见下文
failFunction接口回调,回调参数详见下文

queryString示例

jsCheckObject示例

jsCheckObject字段说明

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

productObject示例

productObject字段说明

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

brand_info字段说明

属性类型必填描述
nameString商家名字
logoString商家logo
phoneString商家电话

sku_list字段说明

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

sku_attr_list字段说明

属性类型必填描述
nameString物品属性值名
valueString物品属性值

poi_list字段说明

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

sku_attr_list字段说明

属性类型必填描述
nameString物品属性值名
valueString物品属性值

接口回调说明

参数名类型说明
errCodeNumber错误码
errMsgString调用结果
extraDataObjectsuccess回调时可能不为空

接口错误类型

errCodeerrMsg说明
0success回调: ok用户点击左上角或点完成按钮返回
-1fail回调: fail system error未知错误
-2fail回调: fail request CGI errorCGI 失败
-3fail回调: fail cancel用户右滑返回或验证appid失败返回
-5fail回调: fail parmameter error参数错误