network.wifi.rssi: Get Wi-Fi signal property

network.wifi.rssi · device scope · permission Config

What it does

Reads the device’s current Wi-Fi signal level (standalone property leaf, suitable for list badges or light polling). Differs from embedded intensity (0–4) in Get Wi-Fi info property and link strength on Get network status property—do not validate with the same enum set. Reflects current signal level; set may be rejected; follow accessMode from this device.capability.list call.

Request URL

POST https://openapi-[DataCenter].easy4ip.com/openapi/v2/device.property.get

Minimum permission

Administrators acting on their own bound devices do not need extra permission. Acting on shared devices requires basic configuration permission. Sub-user binding does not require it. Sub-accounts need Config.

Request parameters

For common request fields and signing, see Signing conventions and Common request payload.

Request example

{
 "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "system": {
 "ver": "1.0",
 "appId": "lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time": 1706511734,
 "nonce": "f5a1ae2d-c09c-4d39-a744-83a5c2c653c2"
 },
 "params": {
 "token": "<yourAccessToken>",
 "deviceId": "TESTIPC000012345",
 "properties": [
 "network.wifi.rssi"
 ]
 }
}

Response data fields

The value is in result.data.properties["network.wifi.rssi"].

Actual type and enum follow the ident bound in device.capability.list; the table below is the common wifi_rssi/11800 five levels plus wired. The same leaf may bind wifi_rssi_3L/16200 (enum 0–4, no 5 wired) or wifi_rssi_customer/1011 (int 0–100 percent—do not parse as 0–5). See Set Wi-Fi signal property.

Response example

{
 "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "result": {
 "code": "0",
 "msg": "Operation is successful",
 "data": {
 "properties": {
 "network.wifi.rssi": "0"
 }
 }
 }
}

Error codes

See Return codes · OP/SN/TK for the full catalog.

See Capability errors.

Set Wi-Fi signal property · Wi-Fi