|
摇一摇周边-摇一摇关注JSAPI
摇一摇关注JS API摇一摇关注JS API目的是为已开通微信摇一摇周边,且有一定开发能力的商户提供摇一摇关注能力。商户可以在摇出来的页面直接调用摇一摇关注接口,实现关注公众账号的功能。
此接口需邮件申请才能开通。,申请条件为:使用摇周边的累计用户达500人。请邮件至zhoubian@tencent.com,邮件格式如下:
标题:申请摇一摇关注接口;内容:1、公众账号名称及appid(wx开头的字符串,在mp平台可查看) 2、数据情况(在摇一摇周边商户后台的效果监控截)符合条件的商户,统一在下周一晚上开通接口权限,不再另行通知。
注意事项:1) 使用摇一摇关注时,不可诱导用户关注,一经查实,封号处罚;2) 摇一摇关注仅在摇一摇周边出来的H5页面才能正常运行。直接在微信浏览器中打开网页,此接口无法运行。开发人员调试的时候注意,必须走完整的摇周边流程,通过摇一摇进入页面测试。数据示例关注JS API调用与微信的JS API调用格式一致,如下:
公用函数 | invoke | 用途 | 主动调用指定API | 通用形式 | BeaconAddContactJsBridge.invoke("API名称", {调用参数}, <回调函数>); | 注意:文档中所有代码只能在微信摇周边的场景下才能正确运行。直接在微信浏览器中打开网页,BeaconAddContactJsBridge不会正确运行。开发人员调试的时候注意,必须走完整的摇周边流程,通过摇一摇进入页面测试。例子:
<!DOCTYPE html><html lang="en"><head> <meta charset="UTF-8"> <title>开发者调用关注JS的example</title></head><body><script type="text/javascript"src="http://zb.weixin.qq.com/nearbycgi/addcontact/BeaconAddContactJsBridge.js"></script><script type="text/javascript"> BeaconAddContactJsBridge.ready(function(){ //判断是否关注 BeaconAddContactJsBridge.invoke('checkAddContactStatus',{} ,function(apiResult){ if(apiResult.err_code == 0){ var status = apiResult.data; if(status == 1){ alert('已关注'); }else{ alert('未关注'); //跳转到关注页 BeaconAddContactJsBridge.invoke('jumpAddContact'); } }else{ alert(apiResult.err_msg) } }); });</script></body></html>
引入BeaconAddContactJsBridge
<script type="text/javascript"src="http://zb.weixin.qq.com/nearbycgi/addcontact/BeaconAddContactJsBridge.js"></script>API详细说明
(一)判断是否关注checkAddContactStatus
a)参数:无,传入{}b)回调函数:function(apiResult){} apiResult.err_code : 错误码,0代表正常返会,IT论坛代表发生错误。 apiResult.err_msg : 错误详情,“ok”代表正常返回,IT论坛代表具体的错误信息。 apiResult.data : 是否关注,1代表已经关注,0代表未关注例子:
BeaconAddContactJsBridge.invoke('checkAddContactStatus',{} ,function(apiResult){ if(apiResult.err_code == 0){ var status = apiResult.data; if(status == 1){ alert('已关注'); }else{ alert('未关注'); } }else{ alert(apiResult.err_msg) } });(二)跳转到关注页jumpAddContact
a)参数:无。JS API通过查询后台获取设备所归属的公众账号,而不是直接在JS API参数中获取,因此只能关注此设备归属的公众账号。b)回调函数:无例子:
BeaconAddContactJsBridge.invoke('jumpAddContact');
摇一摇周边-摇一摇关注JSAPI
摘自:http://mp.weixin.qq.com/wiki/3/9 ... 3d85d98dc06db3.html
|
|