2.26、Get WiFi Scan Results

Get WiFi Scan Results

POSTProduction: https://open.eye4cloud.com/{{open_id}}/open/v1/device/getWiFiScanResults
Request Data
Field Name Required Type Description
device_id Yes string Device ID
timestamp Yes int64 Timestamp in seconds
nonce Yes string Random string, 8-20 characters
sign Yes string See "Sign Generation Examples" for the implementation details
password No string Device password; if omitted, the password registered for the device on the Open Platform is used
data No string Device DATA; an empty string can be passed
imei No string Device IMEI; an empty string can be passed
CURL Request Example
CURL
curl 'https://open.eye4cloud.com/{{open_id}}/open/v1/device/getWiFiScanResults' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "device_id": "xxxx",
    "timestamp": 1758867195,
    "nonce": "",
    "sign": "",
    "password": ""
}'
Response Data
Field Name Type Description
error_code int Status code: 0 indicates success; other values indicate an error
error_message string Error message; success indicates a normal response
data object {}
data.result string
data.ap_number int Number of scanned items
data.wifi_list.ssid string SSID
data.wifi_list.mac string MAC Address
data.wifi_list.security string Encryption Method
data.wifi_list.dbm0 string Signal Quality
data.wifi_list.dbm1 string Signal Quality
data.wifi_list.mode string Type [fixed value]
data.wifi_list.channel string Channel
data.wifi_list.rssi string Signal Strength

Example:

JSON
{
    "error_code": 0,
    "error_message": "success",
    "error_tips": "",
    "data": {
        "result": "ok",
        "ap_number": 2,
        "wifi_list": [
            {
                "ssid": "ZTE-GYW-5G",
                "mac": "b4:7c:a6:1d:fd:00",
                "security": "3",
                "dbm0": "100",
                "dbm1": "100",
                "mode": "0",
                "channel": "48",
                "rssi": "-21"
            },
            {
                "ssid": "TP-LINK_test",
                "mac": "82:29:d5:0f:01:00",
                "security": "2",
                "dbm0": "100",
                "dbm1": "100",
                "mode": "0",
                "channel": "157",
                "rssi": "-31"
            }
        ]
    }
}