1.用途

此处我暂时使用的是之前的测试设备，因为设备已经离线，所以暂时没有当天的报警消息，如果选择all筛选，则默认查询半年内的数据
采用Post方式，请求参数为JSON格式

2.URL

http://124.223.60.234:8181/spartan/device/getTerminalAlarmReport

3.请求参数

3.1.参数示例

{
    "terminalId":"42EA1752-00BF-46C2-8132-6F103B31B24B",
    "startTime":"2022-12-08 10:00:00",
    "endTime":"2022-12-08 16:00:00",
    "userId":"21",
    "pageNum":1,
    "pageSize":20
}

3.2.参数说明

字段 类型 说明 是否必须
terminalId String 终端唯一标识 Y
startTime String 查询开始时间（UTC） Y
endTime String 查询结束时间（UTC） Y
userId String 用户的唯一标识 Y
pageNum int 第几页，如果为0，则不进行分页查询 N
pageSize int 每页显示条数，如果为0，则不进行分页查询 N

4.返回参数

4.1.返回参数示例1(不分页)

{
    "code": 200,
    "message": "Operation succeeded",
    "data": [
        {
            "alarmType": 7,
            "lat": 31.832905,
            "lon": 117.095433,
            "gnssTime": "2022-12-08T10:00:02Z",
            "gnssTimestamp": 1670493602000
        },
        {
            "alarmType": 7,
            "lat": 31.832905,
            "lon": 117.095435,
            "gnssTime": "2022-12-08T10:00:27Z",
            "gnssTimestamp": 1670493627000
        },
        {
            "alarmType": 7,
            "lat": 31.832905,
            "lon": 117.095438,
            "gnssTime": "2022-12-08T10:00:52Z",
            "gnssTimestamp": 1670493652000
        },
        {
            "alarmType": 7,
            "lat": 31.832905,
            "lon": 117.095438,
            "gnssTime": "2022-12-08T10:01:17Z",
            "gnssTimestamp": 1670493677000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.09544,
            "gnssTime": "2022-12-08T10:01:43Z",
            "gnssTimestamp": 1670493703000
        },
        {
            "alarmType": 7,
            "lat": 31.832901,
            "lon": 117.095443,
            "gnssTime": "2022-12-08T10:02:08Z",
            "gnssTimestamp": 1670493728000
        },
        {
            "alarmType": 7,
            "lat": 31.832901,
            "lon": 117.095445,
            "gnssTime": "2022-12-08T10:02:33Z",
            "gnssTimestamp": 1670493753000
        },
        {
            "alarmType": 7,
            "lat": 31.832901,
            "lon": 117.095446,
            "gnssTime": "2022-12-08T10:02:58Z",
            "gnssTimestamp": 1670493778000
        },
        {
            "alarmType": 7,
            "lat": 31.832901,
            "lon": 117.095448,
            "gnssTime": "2022-12-08T10:03:23Z",
            "gnssTimestamp": 1670493803000
        },
        {
            "alarmType": 7,
            "lat": 31.832901,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:03:48Z",
            "gnssTimestamp": 1670493828000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.095453,
            "gnssTime": "2022-12-08T10:04:13Z",
            "gnssTimestamp": 1670493853000
        },
        {
            "alarmType": 7,
            "lat": 31.832905,
            "lon": 117.095451,
            "gnssTime": "2022-12-08T10:04:39Z",
            "gnssTimestamp": 1670493879000
        },
        {
            "alarmType": 7,
            "lat": 31.832906,
            "lon": 117.095451,
            "gnssTime": "2022-12-08T10:05:04Z",
            "gnssTimestamp": 1670493904000
        },
        {
            "alarmType": 7,
            "lat": 31.832906,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:05:29Z",
            "gnssTimestamp": 1670493929000
        },
        {
            "alarmType": 7,
            "lat": 31.832906,
            "lon": 117.095448,
            "gnssTime": "2022-12-08T10:05:54Z",
            "gnssTimestamp": 1670493954000
        },
        {
            "alarmType": 7,
            "lat": 31.832905,
            "lon": 117.095448,
            "gnssTime": "2022-12-08T10:06:19Z",
            "gnssTimestamp": 1670493979000
        },
        {
            "alarmType": 7,
            "lat": 31.832905,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:06:44Z",
            "gnssTimestamp": 1670494004000
        },
        {
            "alarmType": 7,
            "lat": 31.832905,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:07:09Z",
            "gnssTimestamp": 1670494029000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:07:35Z",
            "gnssTimestamp": 1670494055000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:08Z",
            "gnssTimestamp": 1670494080000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:08:25Z",
            "gnssTimestamp": 1670494105000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:08:50Z",
            "gnssTimestamp": 1670494130000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:09:15Z",
            "gnssTimestamp": 1670494155000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:09:40Z",
            "gnssTimestamp": 1670494180000
        },
        {
            "alarmType": 7,
            "lat": 31.832901,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:10:05Z",
            "gnssTimestamp": 1670494205000
        },
        {
            "alarmType": 7,
            "lat": 31.832901,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:10:31Z",
            "gnssTimestamp": 1670494231000
        },
        {
            "alarmType": 7,
            "lat": 31.8329,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:10:56Z",
            "gnssTimestamp": 1670494256000
        },
        {
            "alarmType": 7,
            "lat": 31.8329,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:11:21Z",
            "gnssTimestamp": 1670494281000
        },
        {
            "alarmType": 7,
            "lat": 31.8329,
            "lon": 117.09545,
            "gnssTime": "2022-12-08T10:11:46Z",
            "gnssTimestamp": 1670494306000
        },
        {
            "alarmType": 7,
            "lat": 31.832901,
            "lon": 117.095453,
            "gnssTime": "2022-12-08T10:12:11Z",
            "gnssTimestamp": 1670494331000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.095453,
            "gnssTime": "2022-12-08T10:12:36Z",
            "gnssTimestamp": 1670494356000
        },
        {
            "alarmType": 7,
            "lat": 31.832905,
            "lon": 117.095455,
            "gnssTime": "2022-12-08T10:13:01Z",
            "gnssTimestamp": 1670494381000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.095456,
            "gnssTime": "2022-12-08T10:13:27Z",
            "gnssTimestamp": 1670494407000
        },
        {
            "alarmType": 7,
            "lat": 31.832905,
            "lon": 117.095456,
            "gnssTime": "2022-12-08T10:13:52Z",
            "gnssTimestamp": 1670494432000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.095456,
            "gnssTime": "2022-12-08T10:14:17Z",
            "gnssTimestamp": 1670494457000
        },
        {
            "alarmType": 7,
            "lat": 31.832905,
            "lon": 117.095456,
            "gnssTime": "2022-12-08T10:14:42Z",
            "gnssTimestamp": 1670494482000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.095455,
            "gnssTime": "2022-12-08T10:15:07Z",
            "gnssTimestamp": 1670494507000
        },
        {
            "alarmType": 7,
            "lat": 31.832901,
            "lon": 117.095453,
            "gnssTime": "2022-12-08T10:15:32Z",
            "gnssTimestamp": 1670494532000
        },
        {
            "alarmType": 7,
            "lat": 31.832903,
            "lon": 117.095453,
            "gnssTime": "2022-12-08T10:15:57Z",
            "gnssTimestamp": 1670494557000
        }
    ]
}

4.2.返回参数说明1（不分页）

字段 类型 说明
code int 返回状态，详情参见“返回状态集”
message String 返回结果描述
data List 返回结果体
data说明
字段 类型 说明
gnssTimestamp long 设备上报数据时间戳
gnssTime string 报警产生的时间（UTC）
alarmType int 报警类型
alarmTypeName string 报警类型名称
lat double 纬度(WGS84)
lon double 经度(WGS84)

4.3.返回参数示例2(分页)

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "total": 58,
        "size": 15,
        "data": [
            {
                "alarmType": 203,
                "alarmTypeName": "Light alarm",
                "lat": 0.0,
                "lon": 0.0,
                "gnssTime": "2023-07-24T07:49:29Z",
                "gnssTimestamp": 1690184969000
            },
            {
                "alarmType": 201,
                "alarmTypeName": "Temp&humidity alarm",
                "lat": 0.0,
                "lon": 0.0,
                "gnssTime": "2023-07-24T07:49:28Z",
                "gnssTimestamp": 1690184968000
            },
            {
                "alarmType": 33,
                "alarmTypeName": "Leave fence",
                "lat": 31.827593,
                "lon": 117.09682,
                "gnssTime": "2023-07-24T07:49:27Z",
                "gnssTimestamp": 1690184967000
            },
            {
                "alarmType": 201,
                "alarmTypeName": "Temp&humidity alarm",
                "lat": 0.0,
                "lon": 0.0,
                "gnssTime": "2023-07-24T07:39:25Z",
                "gnssTimestamp": 1690184365000
            }
        ]
    }
}

4.4.返回参数说明2（分页）

字段 类型 说明
code int 返回状态，详情参见“返回状态集”
message String 返回结果描述
data object 分页返回结果体
data说明
字段 类型 说明
total int 总条数
size int 共多少页
data List 返回结果体
data说明
字段 类型 说明
gnssTimestamp long 设备上报数据时间戳
gnssTime string 报警产生的时间（UTC）
alarmType int 报警类型
alarmTypeName string 报警类型名称
lat double 纬度(WGS84)
lon double 经度(WGS84)

5.测试示例

作者：admin  创建时间：2023-03-22 15:50
最后编辑：admin  更新时间：2024-06-13 09:41