Query Tap-to-Run Details

Last Updated on : 2023-06-15 05:05:11

Query the tap-to-run details based on the tap-to-run ID.

API address

GET: /v2.0/iot-03/scenes/{scene_id}

Request parameter

Parameter name Type IN Required Description
scene_id String uri true The ID of a tap-to-run scene.

Return parameter

Parameter name Type Description
result SceneDetailRes The returned result.

Description of result

Parameter name Type Description
name String The name of a specified tap-to-run scene.
dsl SceneDSLRes The language of tap-to-run rules. For more information, see the dsl description below.

Description of dsl

Parameter name Type Description
actions List The list of tap-to-run actions.

Description of actions

Parameter name Type Description
execution_type String The execution type.
execution_rule ActionExecutionRuleRes The execution rule.

Request example

GET: /v2.0/iot-03/scenes/fuNo0KVjeK9e****

Error code

For more information, see error code.

Details of dsl

Parameter name Type Description Required
actions List The list of automation actions. See details of actions. Yes

Details of actions

Parameter name Type Description Required
execution_type String The execution type.
deviceIssue: sent by a device.
deviceGroupIssue: sent by a device group.
delay: delay action.
Yes
execution_rule Object The execution rule. See details of execution_rule. Yes

Details of execution_rule

  1. When execution_type is delay:
Parameter name Type Description Required
delay_seconds Long The delay time. The value range is 1 to 5 × 60 × 60. Unit: second. Yes
  1. When execution_type is deviceIssue or deviceGroupIssue:
Parameter name Type Description Required
execution_id String The ID of a specified device or device group. Yes
function_code String The instruction code of a device or device group. Yes
function_value Object The instruction value of a device or device group. Yes