在鸿云文档Appearance
oneKeyExecV2
调用该接口触发场景联动的一键执行。
使用说明
无。
接口地址
/gateway/openApi
请求方式
POST
请求参数
请求头
| 名称 | 类型 | 描述 |
|---|---|---|
| tokenauthorization | String | 平台颁发的token |
| apiCode | String | 固定值：oneKeyExecV2 |
输入参数 OneKeyExecRequest
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| scenesId | String | 是 | 场景id |
返回数据
| 名称 | 类型 | 描述 |
|---|---|---|
| code | String | 调用成功，返回0，调用失败，查看错误信息。 |
| msg | String | 调用成功，提示"操作成功"，调用失败，查看错误信息。 |
| data | Object | 返回结果。结果内容详情，查看下方示例。 |
| scenesId | String | 场景id。 |
示例
请求示例
json
{
"scenesId": "9b63f96d059f56934f4584859c7b4cf5"
}返回示例
json
{
"code": "0",
"msg": "操作成功",
"data": {
"scenesId": "9b63f96d059f56934f4584859c7b4cf5"
}
}错误码
| 错误码 | 错误码取值 | 解决方案 |
|---|---|---|
| iot.scenes.paramCheckFail | 字段 scenesId场景id不能为空。 | 请传入场景id。 |
| iot.scenes.notExist | 场景不存在。 | 请传入正确的场景id。 |
| iot.scenes.notOnekeyExec | 该场景已被禁用，无法触发一键执行。 | 请先启用场景后，再执行。 |