跳到主要内容

场景列表

更新时间:2026-10-28 10:33:29

调用该接口获取场景列表。开发参考见 场景自动化开发指南


描述值
路径/platform/scene/list
版本号1.0.0
协议HTTPS
请求方法POST

请求参数:​

公共请求参数见 公共请求参数

请求字段类型必选描述
openIdString是三方用户外标id
pageNoInteger是起始页数,从1开始
pageSizeInteger是分页大小,最大50

返回参数:​

返回字段类型描述
idString用于识别请求记录,即对应的请求ID。
codeInt接口返回码字段,请求成功时返回200;请求失败时返回详细的错误码。
messageString调用失败时,返回的出错信息
dataObject响应的结果。
totalInteger场景总数
pageNoInteger页数
pageSizeInteger分页条数
sceneListList场景列表
sceneIdLong场景id
enableBoolean是否启用
nameString场景名称

请求示例:​

x-ca-key: xxxxxxxx
x-ca-timestamp: 1728634151000
x-ca-nonce: 7b25fc15b9434dd98587a077a92b7e42
x-ca-signature: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
Content-Type: application/json;charset=UTF-8

{
"id": "49a7be925e******9b08ba0facf7",
"version": "1.0",
"request": {
"apiVer": "1.0.0"
},
"params": {
"openId": "op******1"
}
}

成功返回示例:​

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
"id": "49a7be925e******9b08ba0facf7",
"code": 200,
"message": "success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 1,
"sceneList": [
{
"sceneId": 1,
"enable": true,
"name": "aa"
}
]
}
}