调用该接口获取场景日志的列表。
路径 | /scene/log/list/get |
版本号 | 1.0.6 |
协议 | HTTP,HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 是 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
pageNo | Int | 是 | 请求的页数,从1开始。 | |
pageSize | Int | 是 | 一次拉取的条目数。取值为:1~100。 | |
groupId | String | 否 | 空间的ID。生活物联网平台赋予空间的唯一标识符。 | |
nowTime | Long | 是 | 1560153120289 | 当前查询日志的时间。返回的是从当前时间往前推15天内的日志。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Int |
接口返回码。200表示成功。 |
|
message | String |
调用失败时,返回的出错信息。 |
|
localizedMsg | String |
本地语言的错误消息。 |
|
data | JSON |
响应结果。如果页面要查看T1之后的某个时间点开始的Log,需要重新指定此时的时间点T2,并且把已查询到的结果全部删除掉,令pageNo=1,重新开始查询。 |
|
pageNo | Int |
返回的当前页号。 |
|
pageSize | Int |
一次拉取的条目数。 |
|
total | Int |
返回的日志总数。 |
|
logs | JSON |
日志列表。返回结果按时间顺序从大到小排列。 |
|
time | Long |
日志时间,单位:毫秒。 |
|
timeZone | String |
时区。 |
|
sceneId | String |
场景ID。 |
|
id | String |
日志ID。 |
|
sceneName | String |
场景名称。 |
|
result | Int |
执行结果。0(表示失败);1(表示成功)。 |
|
icon | String |
场景图标。 |
|
isDelete | Boolean |
场景是否被删除。true(表示已被删除);false(表示没有被删除)。 |
|
iconColor | String |
图标颜色。 |
|
hasDelayedAction | Boolean |
标识场景中是否包含延迟执行的action。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.6",
"iotToken": "token"
},
"params":{
"pageNo": "value0",
"pageSize": "value1",
"groupId": "value2",
"nowTime":1560153120289
}
}
正常返回示例
JSON
格式
{
"id": "4de2c367-c1db-417c-aa15-8c585e595d92",
"code": 200,
"message": null,
"localizedMsg": null,
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 10,
"logs": [
{
"result": 1,
"id": "1234",
"sceneId": "1234",
"sceneName": "testScene",
"time": 1578289023000,
"timeZone": "Asia/Shanghai",
"icon": "http://www.aliyundoc.com/***.png",
"iconColor": "#FFFFFF",
"isDelete": false
}
]
}
}
异常返回示例
JSON
格式
{
"id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
"code": 403,
"message": "request forbidden.",
"localizedMsg": "请求被禁止",
"data": null
}