添加一键执行

本文介绍添加一键执行的 API。

接口描述

可添加不同类型动作的一键执行。动作个数上限 50 个。

接口地址

POST: /v2.0/iot-03/scenes

请求参数

body 说明

dsl 说明

actions 说明

返回参数

请求示例

POST: /v2.0/iot-03/scenes

{
  "name": "这是一个一键执行",
  "dsl": {
    "actions": [
      {
        "execution_type": "delay",
        "execution_rule": {
          "delay_seconds": 60
        }
      },
      {
        "execution_type": "deviceIssue",
        "execution_rule": {
          "execution_id": "vdevo16292691746****",
          "function_code": "bright_value",
          "function_value": 20
        }
      },
      {
        "execution_type": "deviceGroupIssue",
        "execution_rule": {
          "execution_id": "144790134147200****",
          "function_code": "switch_1",
          "function_value": true
        }
      }
    ]
  }
}

返回示例

{
    "result": "OrVvumqZ6G0g****",
    "t": 1635845369037,
    "success": true
}

错误码

参考 错误码。

execution_rule 详细说明

• 当 execution_type 为 delay 时：

  参数名	类型	说明	必填
  delay_seconds	Long	延时时间，取值范围 1~5 * 60 * 60，单位：秒	是

• 当 execution_type 为 deviceIssue 或 deviceGroupIssue 时：

  参数名	类型	说明	必填
  execution_id	String	设备或设备群组 ID	是
  function_code	String	设备或设备群组指令码	是
  function_value	Object	设备或设备群组指令值	是