1.URL

http://124.223.60.234:8080/system/asset/command/sendCommand2Device

2.请求参数

同上面的指令下发组包方式一模一样，此处多了一个参数childMsgId，指的是子命令；params同样是传入JSON字符串

2.1请求头

在Headers里面增加token:对应登录验证成功后，data里面对应的tokenId

2.2.参数示例

{
    "terminalId":"589D6C6B4678434FB962971BA8513432",
    "terminalNum":"162070003356",
    "msgId":33027,
    "msgFlowId":1,
    "childMsgId":0,
    "params":"{\"staticPassword\":\"123456\",\"type\":3,\"times\":1,\"startTime\":\"2023-03-30 00:00:00\",\"endTime\":\"2023-04-01 00:00:00\"}",
    "offline":0
}

2.3.参数说明

字段	类型	说明	是否必须
terminalId	String	系统终端唯一标识	Y
terminalNum	String	终端编号	Y
msgId	int	消息ID，10进制	Y
msgFlowId	int	消息流水号,处于（1~65534）即可，可以随机生成	Y
childMsgId	int	子命令，根据消息ID不同，则对应的子命令代表的意思也不同	Y
params	String	指令参数，根据不同的消息组装不同的参数，转成JSON字符串传入	Y
offline	int	是否离线下发（0：实时下发；1：离线下发（如果当前设备不在线，则设备上线后，系统会自动下发此指令））	Y

传入参数详解

针对不同的消息ID，则下发是对应的字段不同
0x0A（设置使用密码类型）
childMsgId：1：使用静态密码，2：使用动态密码，3：使用多限制静态密码
params对应的JSON字符串如下：

{
    "staticPassword":"123456",
    "type":3,
    "times":1,
    "startTime":"2023-03-30 00:00:00",
    "endTime":"2023-04-01 00:00:00"
}

params传入参数说明

字段	类型	说明	是否必须
staticPassword	String	静态密码 6字节（如果使用动态密码则静态密码为0xfe）	Y
type	int	静态密码使用控制方式(0:无限制；1:使用次数限制使能;2:使用时间限制使能;3:使用次数限制+使用时间限制)	Y
times	int	静态密码次数(1~255),255代表一直有效	Y
startTime	String	静态密码开始时间（yyyy-MM-dd HH:mm:ss),UTC	Y
endTime	String	静态密码结束时间（yyyy-MM-dd HH:mm:ss),UTC	Y

0x0C(上传间隔指令实体类)
childMsgId：默认0
params传入参数说明

字段	类型	说明	是否必须
uploadInterval	int	定位上报间隔（5-65535s）	Y
duration	int	持续时间长度（30-65535s）	Y

0x0D(设置IP及端口)
childMsgId：1：主IP。2：副IP,3：备用IP
params传入参数说明

字段	类型	说明	是否必须
address	String	服务器的IP或者域名（不超过30个字节）	Y
port	int	端口	Y

0x0E(查询所有IP及端口)
childMsgId：默认0
params:无需传入其他参数

0x13(设置物理参数)
childMsgId：默认0
params传入参数说明

字段	类型	说明	是否必须
uploadInterval	int	定位上报间隔（5-65535s）	Y
enable	int	物理量使能标志: 0:都不设置；1:温度；2:湿度；3：温度+湿度；4：光照度；5：光照度+温度；6：光照度+湿度；7：光照度+温度+湿度	Y
thresholdEnable	int	物理量门限有效标志:0:都不生效；1:温度；2:湿度；3：温度+湿度；4：光照度；5：光照度+温度；6：光照度+湿度；7：光照度+温度+湿度	Y
tempThreshold	int	温度门限	Y
humidityThreshold	int	湿度门限	Y
lightThreshold	int	光照门限	Y

0x14(设置锁授权码)
childMsgId：默认0
params传入参数说明

字段	类型	说明	是否必须
code	String	8字节授权码	Y

0x16(远程关机)
childMsgId：默认0
params传入参数说明

字段	类型	说明	是否必须
password	String	锁密码	Y

0x17(屏蔽报警)
childMsgId：默认0
params传入参数说明

字段	类型	说明	是否必须
type	int	屏蔽报警标志 1:屏蔽报警，2：不屏蔽报警	Y
duration	int	屏蔽时间（1-65200）屏蔽报警时间，65278为永久有效，直到下一次开关锁操作结束	Y

0x18(其它设备屏蔽报警上传)
childMsgId：默认1
params传入参数说明

字段	类型	说明	是否必须
type	int	1:本地，2:短信，3:保留，4:RF设备	Y
deviceId	String	屏蔽报警设备ID,8位，type=4时才需要传入	Y
duration	int	屏蔽时间（1-65200）屏蔽报警时间，65278为永久有效，直到下一次开关锁操作结束	Y

0x19(开关锁使能)
childMsgId：默认0
params传入参数说明

字段	类型	说明	是否必须
enable	int	开关锁使能状态；1:开启，2:关闭	Y
dateTime	String	允许运行时间（yyyy-MM-dd HH:mm:ss),UTC	Y

0x1A(定位使能)
childMsgId：默认0
params传入参数说明

字段	类型	说明	是否必须
enable	int	定位使能状态；1:开启，2:关闭	Y

0x1B(震动传感器设置)
childMsgId：默认0
params传入参数说明

字段	类型	说明	是否必须
enable	int	定位使能状态；1:开启，2:关闭	Y
threshold	int	震动门限值	Y

0x1C(RF使能)
childMsgId：默认0
params传入参数说明

字段	类型	说明	是否必须
enable	int	RF使能状态；1:开启，2:关闭	Y

0x1D(联网方式设置)
childMsgId：默认0
params传入参数说明

字段	类型	说明	是否必须
type	int	联网方式（1:长连接，2:间断连接）	Y
onlineDuration	int	间断连接联网时长（单位秒）	Y
offlineDuration	int	间断连接断网时长（单位秒）	Y

3.接口应答

3.1.返回示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": null
}

3.2.返回结果说明

字段	类型	说明
code	int	返回状态
message	String	返回结果描述
data	object	返回结果体

4.请求示例

作者：admin 创建时间：2023-04-16 21:05
最后编辑：admin 更新时间：2025-04-23 17:26

HcIot指令下发