调用该接口获取物的属性timeline数据，最多可以获取设备一年内的数据。

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

请求参数

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

返回数据

名称 类型 示例值 描述
iotid String

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

属性更新的时间。
property String

属性的标识符。
batchId String

批次ID。
timestamp Long

属性采集时间戳。

示例

请求示例

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

正常返回示例

JSON 格式 

{
  "code": 200,
  "message": "success",
  "localizedMsg": null,
  "data": {
    "items": [
      {
        "iotid": "xqxyZjSKzCxxxxvbv0O0010851c00",
        "data": 1.23,
        "modifytime": 1511812747287,
        "property": "LightVolt",
        "batchId": "2fc766c5e7xxxx3ed1f3e4b61803",
        "group": null,
        "timestamp": 1511812747245
      },
      {
        "iotid": "xqxyZjSKzxxxx0O0010851c00",
        "data": 1.24,
        "modifytime": 1511812747288,
        "property": "LightVolt",
        "batchId": "2fc766c5exxxx3ed1f3e4b61803",
        "group": null,
        "timestamp": 1511812747245
      }
    ],
    "timestamp": 1511812747245
  }
}

异常返回示例

JSON 格式 

{}