连Wi-Fi-小程序打通接口文档


上一篇 : 开通微信连Wi-Fi插件 下一篇: 获取Wi-Fi门店列表



目录:

1、连Wi-Fi完成页跳小程序

2、商户主页跳转小程序

3、查询门店Wi-Fi信息接口

1、连Wi-Fi完成页跳转小程序

设置联网完成页接口

场景介绍:
设置需要跳转的小程序,连网完成点击“完成”按钮,即可进入设置的小程序。

fBUTpfZpf15gJRG4L7t6cdvr4P339PsCDbzuCd-IK5e70kJFnIj1WXmUUr6FQf_w.png

注:只能跳转与公众号关联的小程序。

接口调用
接口调用说明

协议:https
请求方式: POST  
请求URL: https://api.weixin.qq.com/bizwifi/finishpage/set?access_token=ACCESS_TOKEN  
POST数据格式:JSON

请求参数说明

参数 是否必填 说明
access_token 调用接口凭证
POST数据 JSON数据

POST数据

数据示例:

{
 "shop_id": 429620,
 "finishpage_url": "",  
 "wxa_user_name": "gh_966b66e00888",  
 "wxa_path": "pages/index/index",  
 "finishpage_type": 1  
}

字段说明

字段 是否必填 说明
shop_name 门店名称
finishpage_url 连网完成页URL,finishpage_type为0时有效
wxa_user_name 连网完成页跳转小程序原始id,finishpage_type为1时有效,要求小程序与公众号有绑定关系
wxa_path 连网完成页跳转小程序路径,finishpage_type为1时有效,需要做urlencode
finishpage_type 连网完成页跳转类型,0为H5,1为小程序

##2、设置顶部banner跳转小程序接口

场景介绍:

用户连Wi-Fi后长期逗留在场所内,可以在连接Wi-Fi后进入微信点击微信聊首页欢迎语,即可进入预先设置的小程序中获得资讯或服务。

hNoGGpmifF9cPCSxMjavK9UDP89WdyV-043tCTLbnVnD_o4B-Mdz4WXWUYEullJ7.png

注:只能跳转与公众号关联的小程序。

接口调用

接口调用说明

协议:https
请求方式: POST  
请求URL:https://api.weixin.qq.com/bizwifi/homepage/set?access_token=ACCESS_TOKEN  
POST数据格式:JSON

请求参数说明

参数 是否必填 说明
access_token 调用接口凭证
POST数据 JSON数据

POST数据

数据示例:

{
   "shop_id": 2200766,  
   "template_id": 2,  
   "struct": {  
       "wxa_user_name": "gh_5cb1b4334f3a",  
       "wxa_path": "index.html?query=abc"  
   }
}

字段说明

字段 是否必填 说明
shop_id 门店ID
template_id 2-关联小程序(支持门店小程序)
struct 连网完成页跳转小程序原始id,finishpage_type为1时有效,要求小程序与公众号有绑定关系
wxa_user_name 账号原始ID
wxa_path 小程序页面路径

3、查询门店WiFi信息接口

场景介绍

接口调用说明

协议:https  
http请求方式: POST  
请求URL:https://api.weixin.qq.com/bizwifi/shop/get?access_token=ACCESS_TOKEN  
POST数据格式:JSON

请求参数说明

参数 是否必填 说明
access_token 调用接口凭证
POST数据 JSON数据

POST数据

数据示例:

{  
 "errcode": 0,  
 "data": {  
   "shop_name": "南山店",  
   "ssid": " WX123",  
   "ssid_list": [  
     "WX123",  
     "WX456"  
   ],  
   "ssid_password_list": [  
     {  
       "ssid": "WX123",  
       "password": "123456789"  
     },  
     {  
       "ssid": "WX456",  
       "password": "21332465dge"  
     }  
   ],  
   "password": "123456789",  
   "protocol_type": 4,  
   "ap_count": 2,  
   "template_id": 1,  
   "homepage_url": "http://www.weixin.qq.com/",  
   "bar_type": 1,  
   "sid":"",  
   "poi_id":"285633617",  
   "homepage_wxa_user_name":"",  
   "homepage_wxa_path":"",  
   "finishpage_url":"",  
   "finishpage_wxa_user_name":"gh_966b66e00888",  
   "finishpage_wxa_path":"pages/index/index",  
   "finishpage_type":1,  
 }  
}

字段说明

字段 是否必填 说明
shop_name 门店名称
ssid 无线网络设备的ssid,未添加设备为空,多个ssid时显示第一个
ssid_list 无线网络设备的ssid列表,返回数组格式
ssid_password_list ssid和密码的列表,数组格式。当为密码型设备时,密码才有值
password 设备密码,当设备类型为密码型时返回
protocol_type 门店内设备的设备类型,0-未添加设备,4-密码型设备,31-portal型设备
ap_count 门店内设备总数
template_id 商家主页(bar条)模板类型 0 默认页 1 自定义h5 2 跳转小程序
homepage_url 商家主页(bar条)链接
bar_type 顶部常驻入口上显示的文本内容:0--欢迎光临+公众号名称;1--欢迎光临+门店名称;2--已连接+公众号名称+WiFi;3--已连接+门店名称+Wi-Fi
finishpage_url 连网完成页链接,finishpage_type为0时有效
sid 商户自己的id,与门店poi_id对应关系,建议在添加门店时候建立关联关系,具体请参考“微信门店接口”
poi_id 门店ID(适用于微信卡券、微信门店业务),具体定义参考微信门店,与shop_id一一对应。
homepage_wxa_user_name 商家主页(bar条)跳转的小程序原始id,template_id为2时有效
finishpage_wxa_user_name 完成页跳转的小程序原始id,finishpage_type为1时有效
inishpage_wxa_path 完成页跳转的小程序路径,需要做urlencode,finishpage_type为1时有效
finishpage_type 完成页跳转类型 0为H5;1为小程序


上一篇 : 开通微信连Wi-Fi插件 下一篇: 获取Wi-Fi门店列表