1.URL
xxxxxxxxxxxxxxx/system/asset/command/sendCommand2Device
其中xxxxxxxxxxxxxxx为节点URL(详情参考:对接说明中4.服务器节点说明)
(上海节点)http://124.223.60.234:8080/system/asset/command/sendCommand2Device
(美国节点)https://cloud.aovx.com/prod/system/asset/command/sendCommand2Device
2.请求参数
2.1请求头
在Headers里面增加token:对应登录验证成功后,data里面对应的tokenId
2.2.参数示例
{
"terminalId":"1957EE0C69614AB3B3AF2755103B0AB6",
"terminalNum":"344050190425",
"msgId":33027,
"msgFlowId":1,
"encryptType":0,
"params":"{\"1\":\"10\"}",
"offline":0
}
2.3.参数说明
字段 | 类型 | 说明 | 是否必须 |
---|---|---|---|
terminalId | String | 系统终端唯一标识 | Y |
terminalNum | String | 终端编号 | Y |
msgId | int | 消息ID,根据不同的设备消息ID会不同,当前我们只有(0x8103,0x8104,0x8105,0x8900,0x8A00),下发的时候转成10进制数值,例如:0x8103=33027 | Y |
msgFlowId | int | 消息流水号,处于(1~65534)即可,可以随机生成 | Y |
encryptType | int | 是否加密(0:不加密;1:加密),默认不加密 | Y |
params | String | 指令参数,根据不同的消息组装不同的参数,转成JSON字符串传入 | Y |
offline | int | 是否离线下发(0:实时下发;1:离线下发(如果当前设备不在线,则设备上线后,系统会自动下发此指令)) | Y |
params说明
针对不同的消息ID,则下发是对应的字段不同
0x8103:终端参数设置
0x8103下发的时候可以同时选择对个参数ID下发
例如:设置在终端心跳间隔,key对应的是命令参数ID,value对应的是将终端心跳间隔设置为10s,则对应的params为
{"1":"10"}
例如:我多选几个参数同时下发,则对应的params为:
{"16":"test","17":"test","18":"123456","19":"47.112.122.222","24":"6608"}
其中key为参数ID,value为对应参数内容
0x8104:查询终端参数
此消息无需参数,params为””即可。
0x8105:终端控制
0x8105指令下发的时候,只能单独选择某一个参数ID
例如:
1. 参数ID=4,终端重启,无其他参数params为”{4:””}”
2. 参数ID=5,恢复出厂设置,无其他参数params为”{5:””}”
3. 参数ID=32,OTA升级;传入参数params为:
{32:{"PROTOCOL":"0","VERSION":"xxxxxxxxxxxxx","MODE":"0","TYPE":"0","URL":"http://47.112.122.222:8080/xxxxx.bin"}}
其中key:32 代表参数ID
value是一个Map,其中
PROTOCOL:升级协议:0:FTP;1:HTTP
VERSION:升级版本号
MODE:升级模式:0:整包升级;1:差分升级
TYPE:升级类型: 0: app 升级;1:代码升级
URL:升级包地址
4. 参数ID=33,油路控制;传入参数params为:
{"33":1}
其中key:33 代表参数ID,value:(0:开;1:关)
5. 参数ID=34,电源控制;传入参数params为:
{"34":0}
其中key:34 代表参数ID,value:(0:关;1:开)
6. 参数ID=35,GPIO输出控制:传入参数params为:
{"35":{"CHANNEL":"1","MODE":"0"}}
其中key:35 代表参数ID,value是一个Map
CHANNEL:通道号(0~15)
MODE:0:关 1:开
7. 参数ID=36,透传AT,参入参数params为:
{"36":"xxxxxxxxxxxxx"}
其中key:36 代表参数ID,value为需要透传的字符串
3.接口应答
3.1.返回示例
{
"code": 200,
"message": "Operation succeeded",
"data": null
}
3.2.返回结果说明
字段 | 类型 | 说明 |
---|---|---|
code | int | 返回状态 |
message | String | 返回结果描述 |
data | object | 返回结果体 |
最后编辑:admin 更新时间:2025-04-26 15:43