设备控制

设备控制接口

请求方式	API	描述
POST	/v1.0/iot-02/building/device/actions/control-dp	设备单控
POST	/v1.0/iot-02/building/devices/actions/control-multi-devices	设备多控

设备单控

功能描述

设备单控。

接口地址

POST /v1.0/iot-02/building/device/actions/control-dp

请求参数

参数名	类型	参数类型	说明	是否必需
projectId	String	body	所属项目 ID	false
deviceId	String	body	设备 ID	false
dpCode	String	body	控制 DP 指令 Code	false
dpValue	String	body	控制 DP 指令	false

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功。true：成功，false：失败
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	Object	返回结果

result 参数说明

boolean{}

请求示例

{
    "projectId":"1424615984265764***",
    "deviceIds":"vdevo163722119881***"，
    "dpCode": "humidity_supply",
    "dpValue": "5000"

}

响应示例

boolean{}

设备多控

功能描述

设备多控。

接口地址

POST /v1.0/iot-02/building/devices/actions/control-multi-devices

请求参数

参数名	类型	参数类型	说明	是否必需
projectId	String	body	项目 ID	false
dpCode	String	body	控制 DP 指令 ID	false
dpValue	String	body	控制 DP 指令	false
deviceIds	List《String》	body	设备 ID 列表	false

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功。true：成功，false：失败
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	Object	返回结果

result 参数说明

boolean{}

请求示例

{
    "projectId":"1424615984265764***",
    "deviceIds":[
        "vdevo163722119881***"
    ],
    "dpCode": "humidity_supply",
    "dpValue": "5000"
}

响应示例

boolean{}

错误码

以下为该接口常见的业务异常。更多的异常错误，请参见全局错误码。

错误码	说明
500	系统错误