调用该接口获取物的事件timeline数据,最多可以获取设备7天的数据。
| 路径 | /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格式
{}
                    该文章对您有帮助吗?