调用该接口批量请求场景详情信息。
路径 | /living/scene/batchget |
版本号 | 1.0.0 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 是 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
sceneIdList | List | 是 | 待查询场景的ID列表。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Int |
接口返回码。200表示成功。 |
|
message | String |
调用失败时,返回的出错信息。 |
|
localizedMsg | String |
本地语言的错误消息。 |
|
data | JSON |
响应结果。 |
|
name | String |
场景的名称。 |
|
icon | String |
场景的图标。 |
|
triggers | String |
场景的触发规则。 |
|
conditions | String |
场景的执行条件。 |
|
actions | String |
场景的执行动作。 |
|
sceneId | String |
场景的ID。生活物联网平台赋予场景的唯一标识符。 |
|
remark | String |
场景备注。 |
|
sceneType | String |
场景规则类型。 |
|
enable | Boolean |
APP上的场景开关状态。true(表示打开,场景可以正常被触发执行);false(表示关闭,即便达到触发条件,场景也不会执行)。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.0",
"iotToken": "token"
},
"params":{
"sceneIdList": "value0"
}
}
正常返回示例
JSON
格式
{
"code":200,
"data":
[
{"sceneType":"IFTTT",
"name":"主灯开关 开启 - 灯模式 mono - 开启",
"icon":"https://img.alicdn.com/tfs/TB10G8xxxxUVXa-144-144.png",
"sceneId":"b8fexxxx26b76c31",
"sceneSwitch":1,
"triggers":"{\"params\":{},\"items\":[{\"params\":{\"eventCode\":\"\",\"compareValue\":1,\"iotId\":\"z8nxxxx00101\",\"compareType\":\"==\",\"propertyName\":\"LightSwitch\",\"propertyValue\":1,\"productKey\":\"a1B0kMs35NW\",\"deviceName\":\"z8nxxxx6SFY\"},\"uri\":\"trigger/device/property\"}],\"uri\":\"logical/or\"}",
"conditions":"{\"params\":{},\"items\":[{\"params\":{\"eventCode\":\"\",\"compareValue\":0,\"iotId\":\"z8nqxxxx000101\",\"compareType\":\"==\",\"propertyName\":\"LightMode\",\"propertyValue\":0,\"productKey\":\"a1B0kMs35NW\",\"deviceName\":\"z8nxxxx6SFY\"},\"uri\":\"condition/device/property\"}],\"uri\":\"logical/and\"}",
"actions":"[{\"params\":{\"switchStatus\":1,\"automationRuleId\":\"50xxxx520ceed\"},\"uri\":\"action/automation/setSwitch\"}]"}
],
"id":"1509086454180"
}
异常返回示例
JSON
格式
{
"id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
"code": 403,
"message": "request forbidden.",
"localizedMsg": "请求被禁止",
"data": null
}