微信小店
微信门店
微信智能接口
微信设备功能

摇一摇关注JSAPI

出自微信公众平台开发者文档
跳转到: 导航, 搜索

摇一摇关注JS API

摇一摇关注JS API目的是为已开通微信摇一摇周边,且有一定开发能力的商户提供摇一摇关注能力。商户可以在摇出来的页面直接调用摇一摇关注接口,实现关注公众账号的功能。

数据示例

关注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代表正常返会,其他代表发生错误。
              apiResult.err_msg : 错误详情,“ok”代表正常返回,其他代表具体的错误信息。
              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');