调用下述接口可以添加portal型设备的网络信息,并获得secretkey。secretkey为加密字符串参数,是portal设备改造流程中的重要参数。为防止secretkey泄露,可通过此接口重置刷新,重置后之前生成的secretkey将会失效。需注意:
同一个门店可以添加多个ssid,最大添加100个ssid;
一个门店只能拥有一种设备类型,只要调用此接口添加一个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。