调用下述接口可以添加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。