1.URL

xxxxxxxxxxxxxxx/system/asset/command/queryTerminalOtaReport
其中xxxxxxxxxxxxxxx为节点URL（详情参考：对接说明中4.服务器节点说明）
（上海节点）http://124.223.60.234:8080/system/asset/command/queryTerminalOtaReport
（美国节点）https://cloud.aovx.com/prod/system/asset/command/queryTerminalOtaReport

2.请求参数

2.1请求头

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

2.2.参数示例

{
    "ids":["1957EE0C69614AB3B3AF2755103B0AB6"],
    "startTime":"2023-02-01 00:00:00",
    "endTime":"2023-02-03 00:00:00",
    "pageNum":1,
    "pageSize":20
}

2.3.参数说明

字段 类型 说明 是否必须
ids List 终端唯一标识集合 Y
startTime String 开始时间（UTC） Y
endTime String 结束时间（UTC） Y
pageNum int 第几页 Y
pageSize int 每页显示条数 Y

3.接口应答

3.1.返回示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "total": 1,
        "size": 1,
        "data": [
            {
                "terminalId": "1957EE0C69614AB3B3AF2755103B0AB6",
                "terminalNum": "344050190425",
                "upgradeInfo": "{\"TYPE\":\"0\",\"MODE\":\"0\",\"PROTOCOL\":\"1\",\"VERSION\":\"natives_blob\",\"URL\":\"http://124.223.60.234:8888/FOTA/103/natives_blob.bin\"}",
                "status": 1,
                "sendTime": "2023-02-02T10:07:39.151Z",
                "sendTimestamp": 1675332459151,
                "dateTime": "2023-02-02T10:07:39.151Z",
                "mark": "E40507ECDCCE400CA1406A8D97AFF250",
                "dateTimestamp": 1675332459151
            }
        ]
    }
}

3.2.返回结果说明

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

data 详情

字段 类型 说明
total String 总条数
size String 多少页
data object 每页的结果集合

data 详情

字段 类型 说明
terminalId String 终端系统唯一标识
terminalNum String 终端编号
upgradeInfo String 指令消息ID
status Integer 更新状态（-1：升级命令下发失败；1：升级命令下发成功，等待终端下载升级包；2：升级开始，终端开始下载升级包；3：升级成功；4：升级失败）
sendTime String 升级时间（UTC）
sendTimestamp String 升级时间UNIX时间戳
dateTime String 最后更新时间（UTC）
dateTimestamp Long 最后更新时间UNIX时间戳
作者：admin  创建时间：2023-04-24 16:53
最后编辑：admin  更新时间：2025-04-26 15:43