调用该接口获取物的属性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 格式

{}