API 概述
了解接口基本功能与认证方式
实时查询
查询服务器最近3天的攻击记录,数据实时从襄阳防火墙获取
密钥认证
每个用户IP对应唯一密钥,必须在防火墙监控页面获取密钥才能查询
跨域支持
支持GET/POST请求方式,返回JSON格式数据,支持跨域调用
该API接口提供襄阳防火墙攻击记录查询功能,允许用户查询指定服务器IP的最近3天攻击日志记录,包括攻击源、攻击类型、持续时间、峰值流量、清洗数据等详细信息。
认证要求
必须提供有效的服务器IP和API密钥才能查询。密钥可在控制台攻击预警页面获取或重置,每个服务器IP对应唯一密钥。
接口详情
接口地址、请求方式与参数
GET / POST
请求参数
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
server_ip
|
String | 必需 | 服务器IP地址 |
key
|
String | 必需 | API密钥(控制台攻击预警页面获取) |
响应示例
成功响应
code=0 表示查询成功
{
"code": 0,
"msg": "查询成功",
"data": [
{
"count": 14131,
"status": 0,
"deftype": "全局过滤模块:syn flood",
"s_ip": "30.0.0.10",
"start_time": "2022-11-10 18:01:41",
"drop_count": 14131,
"drop_size": 7517692,
"id": 68,
"size": 7517692
}
]
}
返回字段说明
count
峰值包数
status
攻击状态 1:进行中 0:已结束
deftype
防护方式
s_ip
服务器IP
start_time
攻击开始时间
end_time
攻击结束时间
drop_count
拦截包数
drop_size
拦截峰值流量(字节)
size
服务器峰值流量(字节)
duration
持续时间
packet_type
包类型
c_ip_list
攻击源IP
错误代码说明
接口返回的状态码及含义
0
成功
查询攻击记录成功,data 字段返回攻击记录列表
-1
查询失败
查询攻击记录过程中出现错误,msg 字段返回错误详情
401
缺少IP
请求中缺少必须的 server_ip 参数
402
IP格式无效
提供的服务器IP地址格式不正确
403
密钥错误
未提供密钥或密钥不正确。请在防火墙监控页面获取有效密钥后重试。