调用该接口获取物的事件timeline数据,最多可以获取设备一年内的数据。

路径 /cloud/thing/event/timeline/get
版本号 1.0.2
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 25000

请求参数

名称 类型 是否必选 示例值 描述
iotId String 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。productKey和deviceName为空时,该入参不允许为空。
identifier String 属性标识符。
eventType String 事件的类型。
start Long timeline起始时间。
end Long timeline终止时间。
pageSize Int 分页查询条数。
ordered Boolean 查询方式。true(表示顺序);false(表示逆序)。
productKey String 产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。当iotId为空时,该参数不允许为空。
deviceName String 设备的名称,设备证书信息之一。在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。当iotId为空时,该参数不允许为空。

返回数据

名称 类型 示例值 描述
eventCode String

事件的标识符。

iotId String

设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。

eventName String

事件的名称。

eventType String

事件的类型。

batchId String

批次ID。

timestamp Long

事件的采集时间。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.2"
	},
	"params":{
		"iotId": "value0",
		"identifier": "value1",
		"eventType": "value2",
		"start": "value3",
		"end": "value4",
		"pageSize": "value5",
		"ordered": "value6",
		"productKey": "value7",
		"deviceName": "value8"
	}
}

正常返回示例

JSON 格式

{
    "code": 200,
    "message": "success",
    "localizedMsg": "",
    "data": {
        "items": [
            {
                "eventCode": "Error",
                "iotId": "YzqEnI5Dxxxxjjo0010840500",
                "eventName": "故障上报",
                "eventType": "info",
                "eventBody": {
                    "ErrorCode": 0
                },
                "batchId": "5ebc6a9c7dxxxxedde6d28c8fb3",
                "timestamp": 1516342985261
            },
            {
                "eventCode": "Error",
                "iotId": "YzqEnI5Dxxxxxxxxjo0010840500",
                "eventName": "故障上报",
                "eventType": "info",
                "eventBody": {
                    "ErrorCode": 0
                },
                "batchId": "4a0b5a7ac8xxxxd5ff77456f1",
                "timestamp": 1516342995305
            }
        ],
        "timestamp": 1516343075699
    }
}

异常返回示例

JSON 格式

{}