---
title: "获取IP组列表"
method: GET
path: "/api/v1/ip-groups"
tags: ["IP组管理"]
---

# 获取IP组列表

`GET /api/v1/ip-groups`

获取所有IP组列表，支持分页

## Query parameters

- `page` integer
- `size` integer

## Response `200`

获取IP组列表成功

- object — 成功的API响应标准格式
  - `code` integer
  - `data` DtoIPGroupListResponse — IP组列表响应
    - `items` ModelIPGroup[] — IP组列表
      - `id` string — 组唯一标识符
      - `items` string[] — IP地址或CIDR列表
      - `name` string — 组名称
    - `total` integer — 总数
  - `message` string
  - `requestId` string
  - `success` boolean
  - `timestamp` string

## Other responses

- `401` — 未授权访问
- `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/versions/aaacd7e06a88/schema)