开通微信连Wi-Fi插件
开通微信连Wi-Fi插件
调用微信连Wi-Fi其他所有接口的前提是已开通“微信连Wi-Fi”功能插件,目前开通插件共有两种方法:1)在微信公众平台通过页面操作添加“微信连Wi-Fi“功能插件;2)调用此接口开通插件。
注:开通插件接口只支持公众号第三方平台调用,公众账号开发者请在微信公众平台自行开通。第三方平台接入,请参考微信开放平台。
开通插件流程
流程详细说明
1. 用户进入第三方平台网站并授权登录
用户需要先进入第三方平台网站,如www.ABC.com。第三方平台引导用户进行微信公众号授权登录操作。
2. 第三方平台获取开插件wifi_token
协议:httpshttp请求方式: GET请求URL:https://api.weixin.qq.com/bizwifi/openplugin/token?access_token=ACCESS_TOKENPOST数据格式:JSON
请求参数说明
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
POST数据 | 是 | JSON数据 |
POST数据
数据示例:
{"callback_url": "http://weixin.qq.com/"}
字段说明:
字段 | 是否必填 | 说明 |
---|---|---|
callback_url | 是 | 回调URL,开通插件成功后的跳转页面。注:该参数域名必须与跳转进开通插件页面的页面域名保持一致,建议均采用第三方平台域名。 |
返回数据说明 正确返回JSON数据示例:
{"errcode": 0,"data": {"is_open": true,"wifi_token": ""}}
字段说明:
字段 | 说明 |
---|---|
is_open | 该公众号是否已开通微信连Wi-Fi插件,true-已开通,false-未开通 |
wifi_token | 开通插件的凭证,当is_open为false时才返回值 |
3. 引导用户进入开通插件页面
第三方平台可以在自己的网页中放置“开通微信连Wi-Fi插件”的入口,引导用户进入开通插件页面。建议第三方平台采用“在当前页面打开“的形式打开开通插件页面。
网址为:https://wifi.weixin.qq.com/biz/mp/thirdProviderPlugin.xhtml?token=xxxx ,该网址中第三方平台需提供已获取的wifi_token。
4. 用户填写信息,开通插件
用户在开通插件页面填写相关信息,完成开通插件操作。
5. 跳转callback_url
用户开通插件成功后,网页将自动跳转到第三方平台调用“获取开通插件wifi_token”接口时提供的callback_url中,完成开通插件流程。之后第三方平台可以调用其他接口为用户提供微信连Wi-Fi服务。