network.wifi.info (Get Wi-Fi info property)
network.wifi.info: Get Wi-Fi info property
network.wifi.info · device scope · permission Config
What it does
Reads the device’s current Wi-Fi information (SSID, connection state, and other detail snapshot fields). Includes sSID, bSSID, status, auth, intensity, isRepeater, and aliasName. intensity inside the struct is signal level 0–4 (1 means no network), which differs from the standalone leaf Get Wi-Fi signal property (network.wifi.rssi, 0–5 including wired) and Get network status property (link overview 0–3): use this page for detail; poll rssi for signal/wired level only; use link.status for link state.
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
| Name | Type | Required | Description |
|---|---|---|---|
token | String | yes | Administrator, sub-user, or sub-account accessToken |
deviceId | String | yes | Device serial number |
productId | String | no | Optional. If sent and it does not match the device model → DV2009 |
properties | Array | yes | ["network.wifi.info"] |
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.info"
]
}
}
Response data fields
The value is in result.data.properties["network.wifi.info"].
| Name | Description | Type | Required | Values |
|---|---|---|---|---|
sSID | Wi-Fi name. | text | yes | String |
bSSID | Wi-Fi unique identifier. | text | yes | String |
status | Connection state. | enum | yes | 0 not connected; 1 connecting; 2 connected |
auth | Wi-Fi authentication mode. | text | yes | String |
intensity | Signal strength. | enum | yes | 0 abnormal; 1 no network; 2 poor; 3 fair; 4 good |
isRepeater | Whether this is a repeater. | int | yes | Integer |
aliasName | Repeater or similar device name. | text | yes | String |
Response example
{
"id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
"result": {
"code": "0",
"msg": "Operation is successful",
"data": {
"properties": {
"network.wifi.info": {
"sSID": "example",
"bSSID": "example",
"status": "0",
"auth": "example",
"intensity": "0",
"isRepeater": 1,
"aliasName": "example"
}
}
}
}
}
Error codes
| Code | Meaning | Next step |
|---|---|---|
SN1001 | Signature error | Check sign per Development specification |
TK1002 | Token invalid or expired | Refresh accessToken |
OP1002 | Missing required parameter | Add required fields |
OP1003 | Invalid parameter | Match this page’s parameter table |
OP1009 | Permission denied | Check token and device bind/share grants |
OP1013 | Total call limit exceeded | Reduce call rate |
OP1014 | Daily per-interface limit exceeded | See Interface call limits |
DV1007 | Device offline | Wait until the device is online |
See Return codes · OP/SN/TK for the full catalog.
| Code | Meaning | Next step |
|---|---|---|
DV2003 | Property not on device | Use device.capability.list |
DV2004 | Value out of range | Check properties values |
DV2007 | channelId vs scope mismatch | Required for channel scope; omit for device scope |
DV2008 | Mixed device and channel properties | Split the request |
DV2009 | productId mismatch | Omit or set actual model id |
See Capability errors.