获取设备状态上报日志

更新时间：2024-09-10 01:49:15

本文介绍获取设备状态上报日志的 API。

接口描述

根据设备 ID，获取设备状态上报日志。

接口地址

GET: /v2.0/cloud/thing/{device_id}/report-logs

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	path	true	设备 ID。
codes	String	query	true	设备支持的功能点。支持多个功能点的查询，用半角逗号（,）隔开，默认为空。
start_time	Long	query	true	查询的开始时间戳。
end_time	Long	query	true	查询的结束时间戳。
last_row_key	String	query	false	最后一条数据的行键。默认值为空，查第一页。
size	Integer	query	true	查询的日志数量大小。默认值为 `20` ，查询条数建议小于`100`。

返回参数

参数名	类型	说明
last_row_key	String	当前页的标识，可作为下一页查询的请求 `lastRowKey` 参数值。
device_id	String	设备 ID。
has_more	Boolean	是否有下一页。
total	Long	符合条件的数据总条数。
logs	List	日志列表。

logs 说明

参数名	类型	说明
code	String	事件编码。
value	Object	状态值。
event_time	Long	事件时间。

请求示例

GET: /v2.0/cloud/thing/{{device_id}}/report-logs?codes=switch_led_1&start_time=1676944806000&end_time=1677141431000&last_row_key=&size=20

返回示例

{
    "tid": "939b81a5b3eb11ed887edada9ae0bcf6",
    "result": {
        "device_id": "vdevo167115422036***",
        "total": 1000,
        "has_more": false,
        "logs": [
            {
                "code": "switch_led_1",
                "value": "true",
                "event_time": 1677141419268
            },
            {
                "code": "switch_led_1",
                "value": "false",
                "event_time": 1677141418601
            },
            {
                "code": "switch_led_1",
                "value": "true",
                "event_time": 1677141398699
            }
        ]
    },
    "t": 1677205989547,
    "success": true
}

错误码

参考错误码。

调用频率限制

参考调用频率限制。