下发动作

更新时间：2023-12-07 03:33:48

本文介绍下发动作的 API。

接口描述

根据设备 ID，设置设备动作信息。

接口地址

POST: /v2.0/cloud/thing/{device_id}/shadow/actions

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	path	true	设备 ID。

body 说明

参数名	类型	参数位置	是否必填	说明
code	String	body	true	设备的动作 code。
input_params	String	body	true	设备支持的动作的属性信息与下发的动作值。JSON 可解析的数据，key 是查询动作得出的 code，value 是需要变更的动作值。

返回参数

参数名	类型	说明
result	JSON	返回数据结果。
success	Boolean	操作是否成功。 `true`：操作成功。 `false`：操作失败。
t	Long	时间戳。
tid	String	链路 ID。

请求示例

POST: /v2.0/cloud/thing/2132131*****/shadow/actions

{
  "code": "action",
  "input_params": "{    \"code\": \"action1\",    \"name\": \"动作输入\",    \"typeSpec\": {      \"maxlen\": 1024,      \"type\": \"string\"    }  }"
}

返回示例

{
    "tid": "77a9807fb74411edb9d75a827c79edfd",
    "result": {
    },
    "t": 1677574021435,
    "success": true
}

错误码

参考错误码。