1.URL

http://124.223.60.234:8080/system/asset/report/queryTerminalAlarm
or Server in US
https://cloud.aovx.com/prod/system/asset/report/queryTerminalAlarm

2.Request parameters

2.1.Request headers

Add token in Headers: After successful login verification, the corresponding tokenId in user login response data

2.2.Parameters example

2.2.1 Query all fields

{
    "ids":["A05FF1D03FA9411DA6540965D1769A0D","42EA1752-00BF-46C2-8132-6F103B31B24B"],
    "startTime":"2022-12-01 16:00:00",
    "endTime":"2023-02-07 16:00:00",
    "fields":[],
    "pageNum":1,
    "pageSize":20
}

2.2.2 Query specified fields

{
    "ids":["A05FF1D03FA9411DA6540965D1769A0D","42EA1752-00BF-46C2-8132-6F103B31B24B"],
    "startTime":"2022-12-01 16:00:00",
    "endTime":"2023-02-07 16:00:00",
    "fields":["alarmType","alarmDesc","lat","lon","lbsCells","gnssTime","recvTime"],
    "pageNum":1,
    "pageSize":20
}

2.3.Parameters description

Field Data type description required
ids List Set of unique terminal identifiers in the system Y
startTime String query start time（UTC） Y
endTime String query end time（UTC） Y
fields List Define query fields (if this parameter is not passed, all queries will be performed) N
pageNum int Paging query for current page number, default 1 Y
pageSize int Paging query displays the number of items per page, default 20 Y

3.Response content

3.1.Response example

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "total": 20596,
        "size": 4120,
        "data": [
            {
                "terminalId": "42EA1752-00BF-46C2-8132-6F103B31B24B",
                "terminalNum": "413050338952",
                "vehicleId": "09072352-DD00-42A8-8D6E-32B252858039",
                "vehicleNum": "num1-413050338952",
                "alarmType": 7,
                "alarmDesc": "",
                "lat": 31.832951,
                "lon": 117.095436,
                "altitude": 63,
                "speed": 0,
                "direction": 299,
                "mileage": 0,
                "lbsCells": "460,0,21771,139532462,35",
                "gnssTime": "2022-12-15T02:49:30Z",
                "recvTime": "2022-12-15T02:52:56.355048Z",
                "gnssTimestamp": 1671072570000,
                "recvTimestamp": 1671072776355
            },
            {
                "terminalId": "42EA1752-00BF-46C2-8132-6F103B31B24B",
                "terminalNum": "413050338952",
                "vehicleId": "09072352-DD00-42A8-8D6E-32B252858039",
                "vehicleNum": "num1-413050338952",
                "alarmType": 7,
                "alarmDesc": "",
                "lat": 31.832953,
                "lon": 117.095438,
                "altitude": 63,
                "speed": 0,
                "direction": 299,
                "mileage": 0,
                "lbsCells": "460,0,21771,139532462,35",
                "gnssTime": "2022-12-15T02:49:05Z",
                "recvTime": "2022-12-15T02:52:18.117782Z",
                "gnssTimestamp": 1671072545000,
                "recvTimestamp": 1671072738117
            },
            {
                "terminalId": "42EA1752-00BF-46C2-8132-6F103B31B24B",
                "terminalNum": "413050338952",
                "vehicleId": "09072352-DD00-42A8-8D6E-32B252858039",
                "vehicleNum": "num1-413050338952",
                "alarmType": 7,
                "alarmDesc": "",
                "lat": 31.832956,
                "lon": 117.095435,
                "altitude": 63,
                "speed": 0,
                "direction": 299,
                "mileage": 0,
                "lbsCells": "460,0,21771,139532462,35",
                "gnssTime": "2022-12-15T02:48:40Z",
                "recvTime": "2022-12-15T02:51:09.203763Z",
                "gnssTimestamp": 1671072520000,
                "recvTimestamp": 1671072669203
            },
            {
                "terminalId": "42EA1752-00BF-46C2-8132-6F103B31B24B",
                "terminalNum": "413050338952",
                "vehicleId": "09072352-DD00-42A8-8D6E-32B252858039",
                "vehicleNum": "num1-413050338952",
                "alarmType": 7,
                "alarmDesc": "",
                "lat": 31.832951,
                "lon": 117.09545,
                "altitude": 61,
                "speed": 0,
                "direction": 299,
                "mileage": 0,
                "lbsCells": "460,0,21771,139532462,35",
                "gnssTime": "2022-12-15T02:48:15Z",
                "recvTime": "2022-12-15T02:50:14.355050Z",
                "gnssTimestamp": 1671072495000,
                "recvTimestamp": 1671072614355
            },
            {
                "terminalId": "42EA1752-00BF-46C2-8132-6F103B31B24B",
                "terminalNum": "413050338952",
                "vehicleId": "09072352-DD00-42A8-8D6E-32B252858039",
                "vehicleNum": "num1-413050338952",
                "alarmType": 7,
                "alarmDesc": "",
                "lat": 31.832953,
                "lon": 117.095461,
                "altitude": 60,
                "speed": 0,
                "direction": 299,
                "mileage": 0,
                "lbsCells": "460,0,21771,139532462,35",
                "gnssTime": "2022-12-15T02:47:50Z",
                "recvTime": "2022-12-15T02:49:03.827949Z",
                "gnssTimestamp": 1671072470000,
                "recvTimestamp": 1671072543827
            }
        ]
    }
}

3.2.Response description

Field Data type description
code int Return code
message String Return message
data object Response data

Response data description

Field Data type description
total String Total number of paged queries
size String How many pages are there for pagination query
data object Result set per page

Per page data description

Field Data type description
terminalId String Unique identification of device in the system
terminalNum String Device number
vehicleId String Unique identification of asset in the system
vehicleNum String asset number
alarmType Integer Alarm type ID
alarmDesc String Alarm description
lat Double latitude(WGS-84)
lon Double longitude(WGS-84)
altitude Integer Altitude, unit: m
speed Double Speed, unit: km/h
direction Integer direction,0~360,0:north
mileage Double Mileage, unit: km
lbsCells String Base Station Information (format: mcc,mnc,lac,ci,rssi)
gnssTime String Data packaging time (UTC)
recvTime String Data receiving time(UTC)
gnssTimestamp long Data packaging timestamp（millisecond）
recvTimestamp long Data receiving timestamp （millisecond）
作者：admin  创建时间：2023-04-25 11:44
最后编辑：admin  更新时间：2024-12-27 19:48