查询设备状态上报日志

更新时间:2023-07-06 07:35:20下载pdf

本文介绍查询设备状态上报日志的 API。

接口描述

查询设备状态上报日志

接口地址

GET: /v1.0/iot-03/devices/{device_id}/report-logs

请求参数

参数名类型参数位置是否必填说明
device_idStringuritrue设备ID
codesStringquerytrue设备支持的功能点。支持多个功能点的查询,用半角逗号(,)隔开,默认为空
start_timeLongquerytrue查询的开始时间戳,13位
end_timeLongquerytrue查询的结束时间戳,13位
sizeIntegerqueryfalse查询的日志数量大小(默认为 20)
last_row_keyStringqueryfalse分页参数, 为上一页请求返回值中的last_row_key, 传参为空时查询第一页

返回参数

参数名类型说明
resultDeviceLogRes

result 说明

参数名类型说明
last_row_keyString当前页的标识, 可作为下一页查询的请求lastRowKey参数值
device_idString设备id
has_moreBoolean是否有下一页
totalLong符合条件的数据总条数
listList数据列表

list 说明

参数名类型说明
codeString状态码
valueObject状态值
event_timeLong事件时间

请求示例

GET: /v1.0/iot-03/devices/xxxid/report-logs?last_row_key=xxx&codes=xxx&start_time=1545898159931&end_time=1545898159935&size=20

返回示例

{
    "result": {
        "last_row_key": "89C8D4D5F7E17A03F1A338xxxx",
        "device_id": "xxxxx",
        "total": 2,
        "has_more": false,
        "logs": [
            {
                "code": "switch_1",
                "value": "false",
                "event_time": 1560872567955
            }
        ]
    },
    "t": 1561344464370,
    "success": true
}

错误码

参考 错误码