调用该接口获取失败场景的日志详情。
路径 | /scene/failedlog/get |
版本号 | 1.0.4 |
协议 | HTTP,HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 是 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
pageNo | Int | 是 | 请求的页数,第一次为1。 | |
pageSize | Int | 是 | 一次拉取的条目数。 | |
logId | String | 是 | 待查询的日志ID。 | |
sceneId | String | 是 | 场景的ID。生活物联网平台赋予场景的唯一标识符。 | |
time | Long | 是 | /scene/log/list/get返回的logs.time,单位:毫秒。 | |
groupId | String | 否 | 空间的ID。生活物联网平台赋予空间的唯一标识符。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
total | Int |
失败场景的总条数。 |
|
pageSize | Int |
一次拉取的条目数。 |
|
pageNo | Int |
请求的页数,不小于1。 |
|
details.productKey | String |
失败设备的详情列表。 |
|
details.localizedProductName | String |
本地化的产品信息。 |
|
details.deviceName | String |
设备的名称,设备证书信息之一。在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。 |
|
details.aliasName | String |
设备起的昵称或别名。 |
|
details.failedReason | String |
错误信息。如果action是设置属性,则文案拼接规则是:{产品名称}-{属性名}-{属性值} 执行失败。如果action是调用服务,则文案拼接规则是:{产品名称}-{服务名称} 执行失败。 |
|
details.detail | String |
下标注释的原因。 |
|
details.icon | String |
图标。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.4",
"iotToken": "token"
},
"params":{
"pageNo": "value0",
"pageSize": "value1",
"logId": "value2",
"sceneId": "value3",
"time": "value4",
"groupId": "value5"
}
}
正常返回示例
JSON
格式
{
"code": 200,
"data": {
"details": [{
"detail": "light-hy - NightLightSwitch - 关闭1 设置设备参数",
"deviceName": "hyxxxxhy",
"failedReason": "device in scene's action is unbind",
"productKey": "b1xxxxrm"
}],
"pageNo": 1,
"pageSize": 1000
},
"message": "success"
}
异常返回示例
JSON
格式
{}