调用下述接口可以添加portal型设备的网络信息,并获得secretkey。secretkey为加密字符串参数,是portal设备改造流程中的重要参数。为防止secretkey泄露,可通过此接口重置刷新,重置后之前生成的secretkey将会失效。需注意:

  1. 同一个门店可以添加多个ssid,最大添加100个ssid;

  2. 一个门店只能拥有一种设备类型,只要调用此接口添加一个ssid后,该门店即为portal型改造设备。如果门店下已有非portal型设备时,无法调用此接口。

接口调用说明

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

请求参数说明

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

POST数据

数据示例:

{
   "shop_id": 429620,
   "ssid": "WX123",
   "reset": false
}

字段说明:

字段 是否必填 说明
shop_id 门店ID
ssid 无线网络设备的ssid,限30个字符以内。 ssid支持中文,但可能因设备兼容性问题导致显示乱码,或无法连接等问题,相关风险自行承担 !
reset 重置secretkey,false-不重置,true-重置,默认为false

返回数据说明

正确返回JSON数据示例:

{
   "errcode": 0,
   "data": {
     "secretkey": "1af08ec5cdb70a4d7365bcd64d3120f6"
   }
}

字段说明:

字段 说明
secretkey 改造portal页面所需参数,该参数用于触发呼起微信的JSAPI接口的sign参数值的计算

注意:

添加设备完成后,务必按照 硬件鉴权协议接口说明进行设备改造,否则无法实现微信连Wi-Fi。