<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# CDN 优选 IP

> 获取主流 CDN 服务商的官方公网 IP 段（CIDR）列表。当前支持 CloudFlare、AWS CloudFront、Gcore 三家，覆盖 IPv4 与 IPv6。常用于 CDN 优选、反向代理、流量分流、防火墙白名单等运维场景。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `cdn-ips` |
| 接口名称 | CDN 优选 IP |
| 接口地址 | `https://v1.apizero.cn/api/cdn-ips` |
| 请求方法 | `GET` |
| 分类 | dev |
| 提供方 | 极数本源 |
| 计费模式 | 免费试用 |
| 单次消耗 | 0 积分 |
| 起步价 | — |
| QPS 限制 | 10 req/s |
| 每日免费额度 | 2000 次（已认证用户） |
| 匿名每日额度 | 100 次（无 API Key） |
| VIP 免费 | 否 |
| 调用总次数 | undefined |

## 2. 认证

匿名可调用：QPS=2、日 100 次；登录后：QPS=10、日 2000 次。

获取 API Key：登录 `https://apizero.cn/account/keys` 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `server` | `string` | 是 | CDN 服务商：cloudflare / cloudfront / gcore（兼容 1/2/3 数字） | — |
| `type` | `string` | 是 | IP 协议版本：v4（IPv4）/ v6（IPv6） | — |

## 4. 请求头

| Header | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `X-API-Key` | `string` | 否 | API Key（不传走匿名额度） | — |

## 5. 请求示例 (cURL)

```bash
curl "https://v1.apizero.cn/api/cdn-ips?server=%3Cserver%3E&type=%3Ctype%3E&key=YOUR_API_KEY"
```

## 6. 响应字段

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `server` | `string` | CDN 服务商显示名（CloudFlare / CloudFront / Gcore） | — |
| `type` | `string` | IP 协议版本（v4 / v6） | — |
| `count` | `number` | IP 段数量 | — |
| `ips` | `string[]` | CIDR 列表，如 "173.245.48.0/20" | — |
| `update_time` | `string` | 本次回源/缓存生成时间（YYYY-MM-DD HH:mm:ss） | — |

## 7. 响应示例

```json
{
    "code": 0,
    "msg": "成功",
    "data": {
        "server": "CloudFlare",
        "type": "v4",
        "count": 15,
        "ips": [
            "173.245.48.0/20",
            "103.21.244.0/22",
            "103.22.200.0/22",
            "...（共 15 条）"
        ],
        "update_time": "2026-05-06 07:55:00"
    },
    "request_id": "mota..."
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `0` | `OK` | 成功 |
| `4000` | `Bad Request` | 参数错误：server 或 type 取值非法 |
| `4011` | `Unauthorized` | API Key 无效 |
| `4013` | `Forbidden` | API Key 已暂停 |
| `4014` | `Forbidden` | 当前 IP 不在 API Key 白名单内 |
| `4022` | `Payment Required` | 余额不足 |
| `4029` | `Too Many Requests` | QPS 限流 |
| `4030` | `Too Many Requests` | 今日免费额度已用完 |
| `5020` | `Bad Gateway` | 上游不可用：CDN 数据源回源失败 / 数据格式异常 |

## 9. 变更日志

- **1.0.0** (2026-05-06)
  - 首次发布：支持 CloudFlare / CloudFront / Gcore 三家 × v4/v6

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/cdn-ips`

Source: `https://apizero.cn/aidocs/cdn-ips/raw.md`
Last updated: 2026-05-11T16:15:07+08:00