查询某个围栏的报警数据

1.用途

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

2.URL

http://124.223.60.234:8181/spartan/fence/queryFenceAlarm

3.请求参数

3.1.参数示例

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

3.2.参数说明

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

4.返回参数

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

{
    "code": 200,
    "message": "Operation succeeded",
    "data": [
        {
            "terminalId": "F944B67B1E144B699A226FFD641526B7",
            "terminalNum": "344056138295",
            "terminalName": "344056138295",
            "terminalColor": "",
            "alarmType": 32,
            "alarmTypeName": "Enter fence",
            "lat": 31.8331,
            "lon": 117.095518,
            "gnssTime": "2023-07-19T11:11:31Z",
            "gnssTimestamp": 1689765091000
        },
        {
            "terminalId": "F944B67B1E144B699A226FFD641526B7",
            "terminalNum": "344056138295",
            "terminalName": "344056138295",
            "terminalColor": "",
            "alarmType": 33,
            "alarmTypeName": "Leave fence",
            "lat": 31.83292,
            "lon": 117.095571,
            "gnssTime": "2023-07-19T12:41:30Z",
            "gnssTimestamp": 1689770490000
        },
        {
            "terminalId": "F944B67B1E144B699A226FFD641526B7",
            "terminalNum": "344056138295",
            "terminalName": "344056138295",
            "terminalColor": "",
            "alarmType": 32,
            "alarmTypeName": "Enter fence",
            "lat": 31.832938,
            "lon": 117.095445,
            "gnssTime": "2023-07-20T02:19:44Z",
            "gnssTimestamp": 1689819584000
        },
        {
            "terminalId": "F944B67B1E144B699A226FFD641526B7",
            "terminalNum": "344056138295",
            "terminalName": "344056138295",
            "terminalColor": "",
            "alarmType": 33,
            "alarmTypeName": "Leave fence",
            "lat": 31.832915,
            "lon": 117.095598,
            "gnssTime": "2023-07-20T06:57:55Z",
            "gnssTimestamp": 1689836275000
        },
        {
            "terminalId": "F944B67B1E144B699A226FFD641526B7",
            "terminalNum": "344056138295",
            "terminalName": "344056138295",
            "terminalColor": "",
            "alarmType": 32,
            "alarmTypeName": "Enter fence",
            "lat": 31.8323026388481,
            "lon": 117.094533295475,
            "gnssTime": "2023-07-24T07:09:43Z",
            "gnssTimestamp": 1690182583000
        },
        {
            "terminalId": "F944B67B1E144B699A226FFD641526B7",
            "terminalNum": "344056138295",
            "terminalName": "344056138295",
            "terminalColor": "",
            "alarmType": 33,
            "alarmTypeName": "Leave fence",
            "lat": 31.827593,
            "lon": 117.09682,
            "gnssTime": "2023-07-24T07:20:37Z",
            "gnssTimestamp": 1690183237000
        },
        {
            "terminalId": "F944B67B1E144B699A226FFD641526B7",
            "terminalNum": "344056138295",
            "terminalName": "344056138295",
            "terminalColor": "",
            "alarmType": 32,
            "alarmTypeName": "Enter fence",
            "lat": 31.8323026388481,
            "lon": 117.094533295475,
            "gnssTime": "2023-07-24T07:29:03Z",
            "gnssTimestamp": 1690183743000
        },
        {
            "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
        }
    ]
}

4.2.返回参数说明1(不分页)

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

data说明

字段	类型	说明
terminalId	String	设备ID
terminalName	String	设备名称
terminalNum	String	S/N码
terminalColor	String	设备颜色
alarmType	String	报警ID
alarmTypeName	String	报警名称
lat	double	纬度(WGS84)
lon	double	经度(WGS84)
gnssTime	String	报警产生的时间，UTC
gnssTimestamp	long	报警产生的UNIX时间戳，毫秒级

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

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "total": 8,
        "size": 1,
        "data": [
            {
                "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": 32,
                "alarmTypeName": "Enter fence",
                "lat": 31.8323026388481,
                "lon": 117.094533295475,
                "gnssTime": "2023-07-24T07:29:03Z",
                "gnssTimestamp": 1690183743000
            },
            {
                "terminalId": "F944B67B1E144B699A226FFD641526B7",
                "terminalNum": "344056138295",
                "terminalName": "344056138295",
                "terminalColor": "",
                "alarmType": 33,
                "alarmTypeName": "Leave fence",
                "lat": 31.827593,
                "lon": 117.09682,
                "gnssTime": "2023-07-24T07:20:37Z",
                "gnssTimestamp": 1690183237000
            },
            {
                "terminalId": "F944B67B1E144B699A226FFD641526B7",
                "terminalNum": "344056138295",
                "terminalName": "344056138295",
                "terminalColor": "",
                "alarmType": 32,
                "alarmTypeName": "Enter fence",
                "lat": 31.8323026388481,
                "lon": 117.094533295475,
                "gnssTime": "2023-07-24T07:09:43Z",
                "gnssTimestamp": 1690182583000
            },
            {
                "terminalId": "F944B67B1E144B699A226FFD641526B7",
                "terminalNum": "344056138295",
                "terminalName": "344056138295",
                "terminalColor": "",
                "alarmType": 33,
                "alarmTypeName": "Leave fence",
                "lat": 31.832915,
                "lon": 117.095598,
                "gnssTime": "2023-07-20T06:57:55Z",
                "gnssTimestamp": 1689836275000
            },
            {
                "terminalId": "F944B67B1E144B699A226FFD641526B7",
                "terminalNum": "344056138295",
                "terminalName": "344056138295",
                "terminalColor": "",
                "alarmType": 32,
                "alarmTypeName": "Enter fence",
                "lat": 31.832938,
                "lon": 117.095445,
                "gnssTime": "2023-07-20T02:19:44Z",
                "gnssTimestamp": 1689819584000
            },
            {
                "terminalId": "F944B67B1E144B699A226FFD641526B7",
                "terminalNum": "344056138295",
                "terminalName": "344056138295",
                "terminalColor": "",
                "alarmType": 33,
                "alarmTypeName": "Leave fence",
                "lat": 31.83292,
                "lon": 117.095571,
                "gnssTime": "2023-07-19T12:41:30Z",
                "gnssTimestamp": 1689770490000
            },
            {
                "terminalId": "F944B67B1E144B699A226FFD641526B7",
                "terminalNum": "344056138295",
                "terminalName": "344056138295",
                "terminalColor": "",
                "alarmType": 32,
                "alarmTypeName": "Enter fence",
                "lat": 31.8331,
                "lon": 117.095518,
                "gnssTime": "2023-07-19T11:11:31Z",
                "gnssTimestamp": 1689765091000
            }
        ]
    }
}

4.4.返回参数说明4(分页)

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

data说明

字段	类型	说明
total	int	总条数
size	int	共多少页
data	List	返回结果体

data说明

字段	类型	说明
terminalId	String	设备ID
terminalName	String	设备名称
terminalNum	String	S/N码
terminalColor	String	设备颜色
alarmType	String	报警ID
alarmTypeName	String	报警名称
lat	double	纬度(WGS84)
lon	double	经度(WGS84)
gnssTime	String	报警产生的时间，UTC
gnssTimestamp	long	报警产生的UNIX时间戳，毫秒级

5.测试示例

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