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

Wi-Fi设备管理

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

目录

添加密码型设备

调用此接口向指定门店添加密码型设备。为保证门店下多台设备无缝漫游,同一个门店下的所有设备必须使用相同的无线网络名称(ssid)和密码。

调用此接口后需要进行以下两步操作,才能正式启用设备:

1.进入无线路由器的管理后台,修改待添加设备的ssid和密码,保证设备的ssid和密码与调用接口时填写的一致;
2.调用“获取物料二维码”接口,下载该门店二维码,张贴于店内。请确保有人(顾客或店员)用6.1以上安卓版微信或6.2.2以上IOS版微信扫码连接Wi-Fi,连网成功即表示设备添加成功。

注:本接口只支持添加密码型设备。

接口调用说明

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

请求参数说明

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

POST数据

数据示例:

{
  "shop_id": 429620,
  "ssid": "WX123",
  "password": "12345689",
}

字段说明:

字段 是否必填 说明
shop_id 门店ID
ssid 无线网络设备的ssid。ssid和密码必须有一个以大写字母“WX”开头;32个字符以内;ssid支持中文,但可能因设备兼容性问题导致显示乱码,或无法连接等问题,相关风险自行承担!
password 无线网络设备的密码。8-24个字符;不能包含中文字符;ssid和密码必须有一个以大写字母“WX”开头

返回数据说明 正确返回JSON数据示例:

{
  "errcode": 0
}


注意:添加设备完成后,请务必调用“获取物料二维码”接口,下载该门店二维码,张贴于店内。并确保有人(顾客或店员)用6.1以上安卓版微信或6.2.2以上IOS版微信扫码连接Wi-Fi,连网成功即表示设备添加成功。

添加portal改造型设备

portal改造型设备添加方法详见“Wi-Fi硬件鉴权协议接口说明

查询设备

可通过指定分页或具体门店ID的方式,查询当前MP账号下指定门店的设备信息。一次最多能查询20个门店的设备信息。

接口调用说明

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

请求参数说明

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

POST数据

数据示例:

分页查询时:
{
   "pageindex": 1,		
   "pagesize":10
}
根据门店ID查询时:
{
   "pageindex": 1,		
   "pagesize":10,
   "shop_id":429620
}

字段说明:

字段 是否必填 说明
pageindex 分页下标,默认从1开始
pagesize 每页的个数,默认10个,最大20个
shop_id 根据门店id查询

返回数据说明 正确返回JSON数据示例:

{
   "errcode": 0,
   "data": {
     "totalcount": 2,
     "pageindex": 1,
     "pagecount": 1,
     "records": [
       {
         "shop_id": 429620,
         "ssid": "WX123",
         "bssid": "00:1f:7a:ad:5b:a9",
         "protocol_type":4
       },
       {
         "shop_id": 429620,
         "ssid": "WX123",
         "bssid": "00:1f:7a:ad:5c:a8",
         "protocol_type":4
       }
     ]
   }
}

字段说明:

字段 说明
totalcount 总数
pageindex 分页下标
pagecount 分页页数
records 当前页列表数组
shop_id 门店ID
ssid 连网设备ssid
bssid 无线MAC地址
protocol_type 门店内设备的设备类型,0-未添加设备,1-专业型设备,4-密码型设备,5-portal自助型设备,31-portal改造型设备


删除设备

根据bssid删除门店下的单个设备。删除后请尽快修改设备的网络名称和密码,或停止使用设备,否则设备会自动重新添加进来。如需清空门店网络及所有设备,请调用“清空门店网络及设备”接口。

接口调用说明

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

请求参数说明

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

POST数据

数据示例:

{
  "bssid":"00:1f:7a:ad:5c:a8"
}

字段说明:

字段 是否必填 说明
bssid 需要删除的无线网络设备无线mac地址,格式冒号分隔,字符长度17个,并且字母小写,例如:00:1f:7a:ad:5c:a8

返回数据说明 正确返回JSON数据示例:

{
   "errcode": 0
}