---
title: "获取封禁IP统计信息"
method: GET
path: "/api/v1/blocked-ips/stats"
tags: ["封禁IP管理"]
---

# 获取封禁IP统计信息

`GET /api/v1/blocked-ips/stats`

获取封禁IP的统计信息，包括总数、生效数、过期数、按原因统计和按小时统计

## Response `200`

获取统计信息成功

- object — 成功的API响应标准格式
  - `code` integer
  - `data` DtoBlockedIPStatsResponse — 封禁IP统计信息
    - `activeBlocked` integer — 当前生效的封禁数量
    - `expiredBlocked` integer — 已过期的封禁数量
    - `last24HourStats` DtoBlockedIPHourlyStats[] — 最近24小时统计
      - `count` integer — 该小时的封禁数量
      - `hour` string — 小时时间点
    - `reasonStats` object — 按原因统计
    - `totalBlocked` integer — 总封禁数量
  - `message` string
  - `requestId` string
  - `success` boolean
  - `timestamp` string

## Other responses

- `401` — 未授权访问
- `403` — 禁止访问
- `500` — 服务器内部错误

---

[API](https://skmtc.net/labring/apis/ruiqi-waf-api.md) · [All operations](https://skmtc.net/labring/apis/ruiqi-waf-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/labring/ruiqi-waf-api/revisions/aaacd7e06a88/schema)