场景列表
更新时间:2025-10-16 15:46:36
调用该接口获取场景列表。开发参考见 场景自动化开发指南
| 描述 | 值 |
|---|---|
| 路径 | /platform/scene/list |
| 版本号 | 1.0.0 |
| 协议 | HTTPS |
| 请求方法 | POST |
请求参数:
公共请求参数见 公共请求参数
| 请求字段 | 类型 | 必选 | 描述 |
|---|---|---|---|
| openId | String | 是 | 三方用户外标id |
| pageNo | Integer | 是 | 起始页数,从1开始 |
| pageSize | Integer | 是 | 分页大小,最大50 |
返回参数:
| 返回字段 | 类型 | 描述 |
|---|---|---|
| id | String | 用于识别请求记录,即对应的请求ID。 |
| code | Int | 接口返回码字段,请求成功时返回200;请求失败时返回详细的错误码。 |
| message | String | 调用失败时,返回的出错信息 |
| data | Object | 响应的结果。 |
| total | Integer | 场景总数 |
| pageNo | Integer | 页数 |
| pageSize | Integer | 分页条数 |
| sceneList | List | 场景列表 |
| sceneId | Long | 场景id |
| enable | Boolean | 是否启用 |
| name | String | 场景名称 |
请求示例:
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",
"sceneId": 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"
}
]
}
}