/network/wifi-scan-results
Use the interface to obtain the result of wifi-scan
Request Mode
POST /api/network/wifi-scan-results
| Parameter | Description |
|---|---|
| iface | The network card name |
Response Body
{
"connect": {
"ssid": "magewell",
"state": 2
},
"user-items": [
{
"ssid": "magewell",
"bssid": "94:a6:7e:61:75:c6",
"frequency": 5220,
"signal": -48,
"encryption": "WPA2PSK",
"is-auto": false,
"is-used": true
}
],
"scan-items": [
{
"ssid": "TP-LINK_8EF4",
"bssid": "18:f2:2c:1e:8e:f4",
"frequency": 2412,
"signal": -39,
"encryption": "WPA2PSK",
"is-auto": false,
"is-used": false
},
{
"ssid": "magewell_005_5GHz",
"bssid": "14:91:82:2b:1f:6d",
"frequency": 5765,
"signal": -40,
"encryption": "WPAPSK",
"is-auto": false,
"is-used": false
},
{
"ssid": "TP-LINK_5G_8EF4",
"bssid": "18:f2:2c:1e:8e:f6",
"frequency": 5200,
"signal": -42,
"encryption": "WPA2PSK",
"is-auto": false,
"is-used": false
},
{
"ssid": "magewell_001",
"bssid": "f0:b4:29:54:8e:b5",
"frequency": 2412,
"signal": -43,
"encryption": "WPAPSK",
"is-auto": false,
"is-used": false
}
],
"status": 0
}
| Name | Description |
|---|---|
| status | 0 indicates that the request was accepted successfully. Refer to API Status Codes to find specific description for other values. |
| connect.ssid | The SSID of the connection |
| connect.state | The AP connection status 0: idle, not connected 1: connecting, please wait 2: connected 3: wrong password 4: connection failed 5: connection timed out |
| user-items[i].ssid | The AP name |
| user-items[i].bssid | The BSSID of the AP |
| user-items[i].frequency | The frequency of the AP |
| user-items[i].encryption | The encryption mode of the AP NONE: unencrypted WEP: WEP encryption mode WPAPSK: WPAPSK encryption mode WPA2PSK: WPA2PSK encryption mode |
| user-items[i].is-auto | Whether automatic connection is allowed |
| user-items[i].is-used | Whether it connects successfully |
| scan-items[i].ssid | The AP name |
| scan-items[i].bssid | The BSSID of the AP |
| scan-items[i].frequency | The frequency of the AP |
| scan-items[i].encryption | The encryption mode of the AP NONE: unencrypted WEP: WEP encryption mode WPAPSK: WPAPSK encryption mode WPA2PSK: WPA2PSK encryption mode |
| scan-items[i].is-auto | Whether automatic connection is allowed |
| scan-items[i].is-used | Whether it connects successfully |