Execute Device Capabilities in Bulk

Last Updated on : 2022-11-11 03:43:46

Execute multiple capabilities of the specified device in bulk. For example, turn on a switch and set the switch countdown at the same time.

API address

POST: /v1.0/iot-03/devices/{device_id}/capabilities

Description of body

Parameter name	Type	IN	Required	Description
capabilities	List		false	The list of commands to execute capabilities of the specified device.

Description of capabilities

Parameter name	Type	Required	Description
code	String	false	The code of the specified capability.
value	Object	true	The value sent to the device.
channels	List	false	The list of capability channels to be controlled, applicable to multi-channel products, such as a power strip.

Parameter name	Type	Description
result	ExecCapabilitiesRes	The returned result.

Description of result

Parameter name	Type	Description
request_result	Boolean	The execution result. Valid values: `true`: All the capabilities are executed successfully. `false`: Failed to execute one capability or several capabilities.

POST: /v1.0/iot-03/devices/64***dz/capabilities

{
  "capabilities": [
    {
      "code": "switch",
      "channel": [
        "1"
      ],
      "value": false
    }
  ]
}

{
    "tid": "7456215360d211ed8b2566906d2287eb",
    "result": {
        "request_result": true
    },
    "t": 1668069252995,
    "success": true
}

For more information, see error code.