连接Wi-Fi
1.接口描述
接口说明：连接Wi-Fi。
请求方式：POST [ip]/api/network/wifi-connect
| 管理员权限 | 登录认证 |
|---|---|
| 是 | 是 |
2.输入参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| iface | 是 | String | 网卡名称，wlan0 |
| ssid | 是 | String | Wi-Fi网络名称 |
| password | 是 | String | 密码，若填写空字符，表示连接未加密的Wi-Fi网络或者已连过的Wi-Fi网络。 |
| is-auto | 是 | Boolean | 是否自动连接 true：是；false：否 |
3.输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
4.示例
连接名为“magewell”的无线网络。
输入示例
{
"iface": "wlan0",
"ssid": "magewell",
"password": "",
"is-auto": true
}
输出示例
{
"status": 0
}
5.错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 定义 | 说明 |
|---|---|---|
| 6 | MW_STATUS_UNKNOWN_ERROR | 位置错误，目标ssid不存在 |
| 7 | MW_STATUS_INVALID_ARG | 参数缺失或错误 |
| 11 | MW_STATUS_DEVICE_BUSY | 操作内容不是无线网卡 |