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

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

2、商户主页跳转小程序

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

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

设置联网完成页接口

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

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

接口调用
接口调用说明

协议：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、户主页跳转小程序

场景介绍：

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

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

接口调用

接口调用说明

协议：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为小程序