1.URL

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

2.请求参数

2.1请求头

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

2.2.参数示例

    {
        "terminalMap":{
            "1957EE0C69614AB3B3AF2755103B0AB6":"344050190425",
            "1957EE0C69614AB3B3AF2755103B0AB7":"344050190427"
        },
        "msgId":33027,
        "msgFlowId":1,
        "encryptType":0,
        "params":"{\"1\":\"10\"}",
        "offline":0
    }

2.3.参数说明

字段 类型 说明 是否必须
terminalMap Map Key为终端系统唯一标识:value为终端号 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下发,界面可以参考下图方式

例如:设置在终端心跳间隔,勾选0x0001即可,下图示例是将终端心跳间隔设置为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,并且根据参数ID有不同的界面呈现
例如:

  1. 参数ID=4,终端重启,无其他参数params为””即可

  2. 参数ID=5,恢复出厂设置,无其他参数params为””即可

  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为需要透传的字符串

详情参见

0x8900与0x8A00暂不做开发

3.接口应答

3.1.返回示例

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

3.2.返回结果说明

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

4.请求示例

作者:admin  创建时间:2023-04-16 21:06
最后编辑:admin  更新时间:2025-06-27 22:39