在鸿云文档Appearance
queryDeviceMsg
调用该接口查询设备消息。
使用说明
暂无
接口地址
/gateway/openapi
请求方式
POST
请求参数
请求头
| 名称 | 类型 | 描述 |
|---|---|---|
| tokenauthorization | String | 平台颁发的token |
| apiCode | String | 固定值：queryDeviceMsg |
请求参数
QueryDeviceMsgRequest
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| productKey | String | 是 | 产品key |
| deviceName | String | 是 | 设备名称 |
| blockPid | String | 否 | 模块标识符，默认是defaultModule |
返回数据
QueryDeviceMsgResponse
| 名称 | 类型 | 描述 |
|---|---|---|
| code | String | 调用成功，返回0，调用失败，查看错误信息。 |
| msg | String | 调用成功，提示"操作成功"，调用失败，查看错误信息。 |
| data | Object | 返回结果。结果内容详情，查看下方示例。 |
deviceMsgList
| 名称 | 类型 | 描述 |
|---|---|---|
| deviceId | String | 设备ID |
| productKey | String | 产品Key |
| deviceName | String | 设备名称 |
| propertyId | String | 属性id |
| blockId | String | 模块id |
| pid | String | 参数标识符 |
| name | String | 参数名称 |
| type | String | 数据类型 |
| desired | String | 属性期望值 |
| newValue | String | 属性最新值 |
| specsUnitName | String | 属性单位id（int、float、double类型特有） |
| updateTime | Date | 更新时间：格式为yyyy-MM-dd HH:mm:ss |
| startTime | Date | 查询开始时间：格式为yyyy-MM-dd HH:mm:ss |
| endTime | Date | 查询结束时间：格式为yyyy-MM-dd HH:mm:ss |
| rate | String | 频率 |
| blockPid | String | 模块标识符 |
示例
请求示例
json
{
"blockId": "54abbeacdb2d4ce287da69f294f1cd23",
"blockPid": "defaultModule",
"deviceId": "652be77b0d0147c3805807e4b8e55e8e",
"productKey": "r1FnjRnGR",
"deviceName": "X2ZQe4QS4"
}返回示例
json
{
"code": "0",
"msg": "操作成功",
"data": [
{
"deviceId": "6b80757247c74a63a48c881813d13dc9",
"productKey": "r1FnjRnGR",
"deviceName": "U2cX8vXkv",
"propertyId": "fceb9ffe6d0843f6aaa8dda47d93fe2c",
"blockId": "54abbeacdb2d4ce287da69f294f1cd23",
"pid": "bts",
"name": "基站信息",
"type": "text",
"desired": null,
"newValue": "460,11,9523,116975893,-60|",
"specsUnitName": null,
"updateTime": "2023-10-10 19:42:52",
"startTime": null,
"endTime": null,
"rate": null,
"blockPid": null
}
]
}