简体中文
简体中文
English
联系我们
注册
登录
语言
简体中文
简体中文
English
联系我们
登录
注册
返回主站
layout空间导航

设备控制

更新时间:2021-09-18 08:41:16下载pdf

您可以使用以下 API 控制您的设备。

API 列表

请求方式 API 说明
POST /v1.0/illumination/devices/{deviceId}/dps 设备单控
POST /v1.0/illumination/devices/dps/multidev 设备多控
POST /v1.0/illumination/devices/dps/group 设备群组控制

设备单控

功能说明

设备单控。

接口地址

POST /v1.0/illumination/devices/{deviceId}/dps

请求参数

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

返回参数

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

result 参数说明

{ "message": "是否成功", "action": "行为" }

请求示例

{ "dpValue": "控制DP指令", "dpCode": "控制DP指令Code", "projectId": "所属项目ID", "deviceId": "设备ID" }

响应示例

{ "message": "SUCCESS", "action": "设备单控" }

设备多控

功能说明

设备多控。

接口地址

POST /v1.0/illumination/devices/dps/multidev

请求参数

参数名 类型 参数类型 说明 是否必填
projectId String body 项目 ID
deviceIds String[] body 设备 ID 列表
dpCode String body 控制 DP 指令 ID
dpValue String body 控制 DP 指令

返回参数

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

result 参数说明

{ "message": "是否成功", "action": "行为" }

请求示例

{ "dpValue": "", "workMode": "", "dpCode": "", "projectId": "" }

响应示例

{ "message": "SUCCESS", "action": "设备多控" }

设备群组控制

功能说明

设备群组控制。

接口地址

POST /v1.0/illumination/devices/dps/group

请求参数

参数名 类型 参数类型 说明 是否必填
projectId String body 所属项目 ID
roomId String body 所属房间 ID
dpCode String body 控制 DP 指令 ID
dpValue String body 控制 DP 指令

返回参数

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

result 参数说明

{ "message": "是否成功", "action": "行为" }

请求示例

{ "dpValue": "", "workMode": "", "dpCode": "", "projectId": "", "roomId": "" }

响应示例

{ "message": "SUCCESS", "action": "设备群控" }

错误码

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

错误码 说明
500 系统错误
1106 非法权限