文档
测试

发送指令到设备

POST
https://api.v2.box.hetuntech.cn/mp/gateway

公共参数

|参数名|类型|是否必选|最大长度 |说明| 示例值| |-|-|-|-|-|-| |appId |String |是 |32|调用方ID |202101012300007148 | |timestamp |String |是 |19 |发送请求的时间,格式"YYYY-MM-DD HH:mm:ss"|2021-04-28 16:13:46| |signType |String |是 |32|签名方式 固定参数值 "MD5" |MD5 | |sign |String |是 |344 |根据MD5算法生成,详见开发流程[签名生成示例](doc:89V4EkDr) |70798ADDC0DDE0698A4E66BE10480FE1 | |method |String |是 |128 | 调用的接口名称 固定参数值 "cabinet.sendDeviceCmd" |cabinet.sendDeviceCmd| |bizContent |String|是 ||请求参数的集合,最大长度不限,一般是json字符除公共参数外所有请求参数都必须放在这个参数中传递 | 见下方示例|

请求参数

参数名
类型
描述
必填
deviceId
String
设备编号
必填
cmdType
cmdTypeEnum
设备指令名称,见下方枚举
必填
params
String
指令业务参数(可不填)
必填

cmdTypeEnum

参数名
类型
描述
必填
forceOpenTheDoor
强制开门,params可传{doorId:1}指定门,默认开双门
必填
reboot
设备重启
必填
addVoiceSystem
增加声音
必填
subVoiceSystem
减小声音
必填
setTemperatureValue
设置文档,e.g. params:{setCabinetTemperature:10}设置成10度
必填

响应参数

参数名
类型
描述
必填
code
int
状态码
必填
message
String
返回消息
必填

说明 / 示例

## 发送参数示例 ```JSON { "appId": "2021062800002", "bizContent": "{\"deviceId\":\"863410048892313\",\"cmdType\":\"forceOpenTheDoor\"}", "method": "cabinet.sendDeviceCmd", "msgId": "204429614355841024", "timestamp": "2021-08-09 16:06:53", "sign": "901CE08FE257AFDF2C4951FA86B5D04D" } ``` ## 返回参数示例 ```JSON { "code": 0, "message": "已发送指令", "data": {} } ``` ## 设备发送指令(event)说明 |指令名|业务参数|说明| 纯动态柜| 动态重力柜| 纯重力柜| 静态柜| |-|-|-|-|-|-|-| | forceOpenTheDoor |无 | 无需设备检测,发送开锁指令 |支持|支持|支持|支持| | reboot |无 | 远程发送重启指令 |支持|支持|**不支持**|支持| | addVoiceSystem |无 | 加大设备音量 |支持|支持|**不支持**|支持| | subVoiceSystem |无 | 减少设备音量 |支持|支持|**不支持**|支持| | initialDevice |无 | 初始化设备 |**不支持**|**不支持**|**不支持**|支持|