获取物的属性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
}