如何获取物的属性timeline数据_生活物联网平台（飞燕平台）-阿里云帮助中心

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

路径	/living/device/property/timeline/get
版本号	1.0.0
协议	HTTPS
请求方法	POST
是否需要用户身份鉴权	是
超时时间	10000

请求参数

名称	类型	是否必选	示例值	描述
iotId	String	是		设备ID，生活物联网平台为设备颁发的ID，设备的唯一标识符。
identifier	String	是		属性的标识符。
start	Long	是		timeline起始时间，单位：毫秒。
end	Long	是		timeline终止时间，单位：毫秒。
limit	Int	是		最多查询条数。
order	String	是		asc: 表示按时间升序查询；desc：表示按时间降序查询。
origin	String	否		调用来源。
userType	String	否		账号类型："TAOBAO" 、"ALIPAY"。
userId	String	否		账号ID。

返回数据

名称	类型	示例值	描述
code	Int		接口返回码。200表示成功。
message	String		调用失败时，返回的出错信息。
localizedMsg	String		本地语言的错误消息。
data	JSON		调用的响应结果。
items	JSON		属性数据列表。
iotid	String		设备ID，生活物联网平台为设备颁发的ID，设备的唯一标识符。
property	String		属性的标识符。
data	String		设备的timeline数据。
modifytime	Long		属性更新时间。
timestamp	Long		属性采集时间戳。
batchId	String		批次ID，同一批上报的属性具有相同的批次ID。
timestamp	Long		时间戳。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.0",
		"iotToken": "token"
	},
	"params":{
		"iotId": "value0",
		"identifier": "value1",
		"start": "value2",
		"end": "value3",
		"limit": "value4",
		"order": "value5",
		"origin": "value6",
		"userType": "value7",
		"userId": "value8"
	}
}

正常返回示例

JSON格式

{
    "id": "4de2c367-c1db-417c-aa15-8c585e595d92",
    "code": 200,
    "message": null,
    "localizedMsg": null,
    "data": {
        "items":[
            {
                "iotid": "D95D24294xxxxxxxx4F31A2697",
                "data": "1.23",
                "modifytime": 1511812747287,
                "property": "Lixxxxt",
                "batchId": "2fc766cxxxxxxxxed1f3e4b61803",
                "group": null,
                "timestamp": 1511812747245
            }
        ],
        "timestamp": 1511812747245
    }
}

异常返回示例

JSON格式

{
    "id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
    "code": 403,
    "message": "request forbidden.",
    "localizedMsg": "请求被禁止",
    "data": null
}