查询用户下所有设备的报警报告

1.用途

如果选择all筛选，则默认查询半年内的数据
采用Post方式，请求参数为JSON格式

2.URL

http://124.223.60.234:8181/spartan/report/queryTerminalsAlarmReport

3.请求参数

3.1.参数示例

{
    "userId":"21",
    "startTime":"2023-07-18 16:00:00",
    "endTime":"2023-08-19 15:59:59",
    "pageNum":1,
    "pageSize":4
}

3.2.参数说明

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

4.返回参数

4.1.返回参数示例1（不分页）

{
    "code": 200,
    "message": "Operation succeeded",
    "data": [
        {
            "terminalId": "1957EE0C69614AB3B3AF2755103B0AB6",
            "terminalNum": "344050190425",
            "terminalName": "344050190425",
            "terminalColor": "",
            "alarmType": 209,
            "alarmTypeName": "Sharp deceleration",
            "lat": 22.803695,
            "lon": 113.875525,
            "gnssTime": "2023-07-05T12:51:09Z",
            "gnssTimestamp": 1688561469000
        },
        {
            "terminalId": "1957EE0C69614AB3B3AF2755103B0AB6",
            "terminalNum": "344050190425",
            "terminalName": "344050190425",
            "terminalColor": "",
            "alarmType": 209,
            "alarmTypeName": "Sharp deceleration",
            "lat": 22.803695,
            "lon": 113.875525,
            "gnssTime": "2023-07-05T12:51:09Z",
            "gnssTimestamp": 1688561469000
        },
        {
            "terminalId": "1957EE0C69614AB3B3AF2755103B0AB6",
            "terminalNum": "344050190425",
            "terminalName": "344050190425",
            "terminalColor": "",
            "alarmType": 209,
            "alarmTypeName": "Sharp deceleration",
            "lat": 22.803695,
            "lon": 113.875525,
            "gnssTime": "2023-07-05T12:51:09Z",
            "gnssTimestamp": 1688561469000
        },
        {
            "terminalId": "1957EE0C69614AB3B3AF2755103B0AB6",
            "terminalNum": "344050190425",
            "terminalName": "344050190425",
            "terminalColor": "",
            "alarmType": 209,
            "alarmTypeName": "Sharp deceleration",
            "lat": 22.803695,
            "lon": 113.875525,
            "gnssTime": "2023-07-05T12:51:09Z",
            "gnssTimestamp": 1688561469000
        },
        {
            "terminalId": "1957EE0C69614AB3B3AF2755103B0AB6",
            "terminalNum": "344050190425",
            "terminalName": "344050190425",
            "terminalColor": "",
            "alarmType": 209,
            "alarmTypeName": "Sharp deceleration",
            "lat": 22.803695,
            "lon": 113.875525,
            "gnssTime": "2023-07-05T12:51:09Z",
            "gnssTimestamp": 1688561469000
        },
        {
            "terminalId": "1957EE0C69614AB3B3AF2755103B0AB6",
            "terminalNum": "344050190425",
            "terminalName": "344050190425",
            "terminalColor": "",
            "alarmType": 209,
            "alarmTypeName": "Sharp deceleration",
            "lat": 22.803695,
            "lon": 113.875525,
            "gnssTime": "2023-07-05T12:51:09Z",
            "gnssTimestamp": 1688561469000
        },
        {
            "terminalId": "1957EE0C69614AB3B3AF2755103B0AB6",
            "terminalNum": "344050190425",
            "terminalName": "344050190425",
            "terminalColor": "",
            "alarmType": 209,
            "alarmTypeName": "Sharp deceleration",
            "lat": 22.803695,
            "lon": 113.875525,
            "gnssTime": "2023-07-05T12:51:09Z",
            "gnssTimestamp": 1688561469000
        }
    ]
}

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

字段	类型	说明
code	int	返回状态，详情参见“返回状态集”
message	String	返回结果描述
data	List	返回结果体

data说明

字段	类型	说明
terminalId	string	设备唯一标识
terminalNum	string	设备S/N
terminalName	string	设备名称
terminalColor	string	设备颜色
gnssTimestamp	long	设备上报数据时间戳
gnssTime	string	报警产生的时间（UTC）
alarmType	int	报警类型ID
alarmTypeName	string	报警类型名称
lat	double	纬度(WGS84)
lon	double	经度(WGS84)

4.3.返回参数示例2（分页）

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "total": 58,
        "size": 15,
        "data": [
            {
                "terminalId": "F944B67B1E144B699A226FFD641526B7",
                "terminalNum": "344056138295",
                "terminalName": "344056138295",
                "terminalColor": "",
                "alarmType": 203,
                "alarmTypeName": "Light alarm",
                "lat": 0.0,
                "lon": 0.0,
                "gnssTime": "2023-07-24T07:49:29Z",
                "gnssTimestamp": 1690184969000
            },
            {
                "terminalId": "F944B67B1E144B699A226FFD641526B7",
                "terminalNum": "344056138295",
                "terminalName": "344056138295",
                "terminalColor": "",
                "alarmType": 201,
                "alarmTypeName": "Temp&humidity alarm",
                "lat": 0.0,
                "lon": 0.0,
                "gnssTime": "2023-07-24T07:49:28Z",
                "gnssTimestamp": 1690184968000
            },
            {
                "terminalId": "F944B67B1E144B699A226FFD641526B7",
                "terminalNum": "344056138295",
                "terminalName": "344056138295",
                "terminalColor": "",
                "alarmType": 33,
                "alarmTypeName": "Leave fence",
                "lat": 31.827593,
                "lon": 117.09682,
                "gnssTime": "2023-07-24T07:49:27Z",
                "gnssTimestamp": 1690184967000
            },
            {
                "terminalId": "F944B67B1E144B699A226FFD641526B7",
                "terminalNum": "344056138295",
                "terminalName": "344056138295",
                "terminalColor": "",
                "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说明

字段	类型	说明
terminalId	string	设备唯一标识
terminalNum	string	设备S/N
terminalName	string	设备名称
terminalColor	string	设备颜色
gnssTimestamp	long	设备上报数据时间戳
gnssTime	string	报警产生的时间（UTC）
alarmType	int	报警类型ID
alarmTypeName	string	报警类型名称
lat	double	纬度(WGS84)
lon	double	经度(WGS84)

5.测试示例

作者：admin 创建时间：2023-04-19 14:13
最后编辑：admin 更新时间：2024-06-13 09:41