查询围栏告警

更新时间：2023-06-20 14:52:23下载pdf

本文介绍查询围栏告警的 API。

接口描述

分页查询围栏告警。

接口地址

GET: /v2.0/iot-01/fences/warn/list

请求参数

参数名	类型	参数位置	是否必填	说明
tag	String	query	false	维度标签，支持通过自定义维度标记对电子围栏进行分类；查询电子围栏时，支持通过维度标记筛选
fence_id	Long	query	false	围栏 ID
entity_id	String	query	false	监控对象 ID，目前为设备 ID
bind_type	Integer	query	false	围栏绑定类型： 1：私有围栏 2：公共围栏
warn_type	Integer	query	false	告警类型： 1：进围栏 2：出围栏
start_time	Long	query	false	开始时间 13 位毫秒时间戳
end_time	Long	query	false	结束时间 13 位毫秒时间戳
page_index	Integer	query	false	分页索引，默认值为 1
page_size	Integer	query	false	分页大小，默认值为 200
last_row_key	Long	query	false	上一页最后一个告警 ID，分页时候： page_index 与 last_id 方式二选一。last_id 只支持下一页，查询速度快，查询第一页不传；page_index 支持跳页，查询数据量大的时候查询速度慢。
coord_type	String	query	false	经纬度定位坐标系类型： WGS84：谷歌坐标系 GCJ02：高德 BD09LL：百度不传：国内默认高德，国外默认谷歌

返回参数

参数名	类型	说明
result	PageRes

result 说明

参数名	类型	说明
data	List	当前页数据列表
total	Long	总的查询结果数量
last_row_key	Long	当前页最后一个数据的自增 ID
last_page	Boolean	是否最后一页，true：是； false：否

data 说明

参数名	类型	说明
id	Long	告警记录 ID
fence_id	Long	围栏 ID
entity_id	String	触发实体 ID
fence_name	String	围栏名称
bind_type	Integer	围栏绑定类型： 1：私有围栏 2：公共围栏
warn_type	Integer	告警类型： 1：进围栏 2：出围栏
lon	Double	上报经度
lat	Double	上报纬度
report_time	Long	上报时间
gmt_create	Long	创建时间

请求示例

GET: /v2.0/iot-01/fences/warn/list?tag=ceshi&fence_id=1000&entity_id&bind_type&warn_type&start_time&end_time&page_index&page_size&last_row_key

返回示例

{
    "result": {
        "last_row_key": 1000,
        "data": [
            {
                "gmt_create": 1626059445000,
                "lon": 20.01,
                "entity_id": "vdevo16245017293****",
                "fence_id": 1000,
                "fence_name": "第一个围栏",
                "bind_type": 1,
                "report_time": 1626059445000,
                "id": 1000,
                "warn_type": 1,
                "lat": 121.09
            }
        ],
        "last_page": true,
        "total": 1
    },
    "t": 1625231333342,
    "success": true
}

错误码

参考错误码。

上一篇告警管理