在鸿云文档

Appearance

queryScenesList ​

调用该接口查询多个场景规则列表。

使用说明 ​

无。

接口地址 ​

/gateway/openapi

请求方式 ​

POST

请求参数 ​

请求头 ​

名称类型描述
tokenauthorizationString平台颁发的token
apiCodeString固定值：queryScenesList

QueryScenesListRequest ​

名称类型是否必选描述
scenesIdsList<String>是场景id集合

返回数据 ​

名称类型描述
codeString调用成功，返回0，调用失败，查看错误信息。
msgString调用成功，提示"操作成功"，调用失败，查看错误信息。
dataObject返回结果。结果内容详情，查看下方示例。

QueryScenesListResponse ​

名称类型是否必选描述
scenesIdString是场景唯一标识
nameString是场景名称
descriptionString否场景描述
createTimeString是创建时间，格式：yyyy-MM-dd HH:mm:ss
statusInteger是启用状态，0：未启用，1：已启用

示例 ​

请求示例 ​

json
{
    "scenesIds": [
        "4865c417e47268ee9f54213e8136a997",
        "9215a90979558804d5e6bc1851bab501"
    ]
}

返回示例 ​

json
{
    "code": "0",
    "msg": "操作成功",
    "data": [
        {
            "scenesId": "4865c417e47268ee9f54213e8136a997",
            "name": "属性命令测试1",
            "createTime": "2024-03-26 10:37:20",
            // 场景状态：0：未启用，1：已启用
            "status": 1
        },
        {
            "scenesId": "9215a90979558804d5e6bc1851bab501",
            "name": "场景",
            "createTime": "2024-03-22 15:46:13",
            // 场景状态：0：未启用，1：已启用
            "status": 1
        }
    ]
}

错误码 ​

错误码错误码取值解决方案
iot.scenes.paramCheckFail字段 scenesIds场景id列表不能为空。请传入场景scenesIds。