1. 基本信息
| 接口地址 | https://v1.apizero.cn/api/cdn-ips |
|---|
| 请求方法 | GET |
|---|
| 分类 | dev |
|---|
| 提供方 | 极数本源 |
|---|
| 计费模式 | 免费试用 |
|---|
| 单次消耗 | 0 积分 |
|---|
| 起步价 | — |
|---|
| QPS 限制 | 10 req/s |
|---|
| 每日免费额度 | 2000 次（已认证用户） |
|---|
| 匿名每日额度 | 100 次（无 API Key） |
|---|
| VIP 免费 | 否 |
|---|
| 调用次数 | |
|---|
3. 请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|
server | string | 是 | CDN 服务商：cloudflare / cloudfront / gcore（兼容 1/2/3 数字） | — |
type | string | 是 | IP 协议版本：v4（IPv4）/ v6（IPv6） | — |
5. 请求示例 (cURL)
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. 响应示例
{
"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