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  创建时间:2023-04-24 16:42
最后编辑:admin  更新时间:2025-04-26 15:43