network.zigbee.rssi(获取Zigbee信号属性)
network.zigbee.rssi:获取Zigbee信号属性
network.zigbee.rssi · 设备级 · 权限 Config
功能详情
读 Zigbee 信号档位(IoT zigbee_signal_strength/15900 · 只读 device.property.get)。JSON 多为 string 枚举 "1"~"5"。
请求地址
POST https://openapi.lechange.cn/openapi/v2/device.property.get
最小权限
管理员操作自己绑定的设备不需要权限。操作被分享设备需要基础配置权限。子用户绑定不需要。子账号需要 Config。见 权限码。设备级不要传 channelId。设备和通道写在同一次请求里返回 DV2008。
传入参数说明
| 参数名 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
token | String | 是 | 管理员、子用户或子账号 accessToken |
deviceId | String | 是 | 设备序列号 |
productId | String | 否 | 可省略。传了且与该设备实际型号不一致 → DV2009 |
properties | Array | 是 | ["network.zigbee.rssi"] |
样例输入
{
"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.zigbee.rssi"]
}
}
返回 data 字段说明
值在 result.data.properties["network.zigbee.rssi"]。
| 类型 | 取值(enum,JSON 多为 string) | 说明 |
|---|---|---|
enum | 1 | 较好 |
2 | 好 | |
3 | 较差 | |
4 | 差 | |
5 | 未加载 |
样例输出
{
"id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
"result": {
"code": "0",
"msg": "Operation is successful",
"data": {
"properties": {
"network.zigbee.rssi": "3"
}
}
}
}
错误码
网关
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
SN1001 | 签名异常 | 按 签名 核对 sign |
TK1002 | token 无效或过期 | 重新获取 token |
OP1002 | 缺少必填参数 | 补必填字段 |
OP1003 | 参数不合法 | 按本页参数表核对 |
OP1039 | 分钟级限流 | 等到下一分钟再试 |
OP1040 | 调用超限 | 降低频率 |
DV1007 | 设备离线或超时 | 等设备上线 |
DV20xx
include 未找到:devcap/errors/dv20-get.md