调用云端API获取设备属性timeline数据-生活物联网平台（飞燕平台）-阿里云

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

路径	/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格式

{}