批量执行设备能力

更新时间:2022-11-11 03:43:43

本文介绍批量执行设备能力的 API。

接口描述

将设备中的能力批量执行。例如,同时打开开关并且设置开关倒计时。

接口地址

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

请求参数

body 说明

参数名类型参数位置是否必填说明
capabilitiesList false能力指令列表。

capabilities 说明

参数名类型参数位置是否必填说明
codeString false指定的能力 code。
valueObject true下发的值。
channelsList false需要控制的能力通道列表,作用于多路产品,比如排插。

返回参数

参数名类型说明
resultExecCapabilitiesRes返回结果。

result 说明

参数名类型说明
request_resultBoolean执行结果。取值范围:
  • true:所有能力都执行成功。
  • false:某个或某些能力执行失败。

请求示例

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
}

错误码

参考 错误码