加载接口文档…
37
累计调用
4ms
平均响应
100.00%
服务可用性
5,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 1,000 次 · QPS 1
登录免费
当前方案每日 5,000 次 · QPS 5
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/cf-dns/raw.md接口请求地址
https://v1.apizero.cn/api/cf-dns
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/cf-dns
接口信息备注
需要登录 API Key（涉及用户 Token，不开放匿名访问）。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| domain | string | 必填 · 根域名 · 示例：example.com |
| host | string | 必填 · 主机记录 @ / www · 示例：home |
| ip | string | 必填 · 要设置的 IP |
| token | string | 必填 · Cloudflare API Token |
| type | string | 可选 · A / AAAA（默认 A） |
| ttl | number | 可选 · TTL 120-86400（默认 120） |
| proxied | bool | 可选 · 是否启用 CDN 代理（默认 false） |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| old_ip | string | 更新前的 IP |
| new_ip | string | 更新后的 IP |
| changed | bool | 是否实际有变化 |
| zone_id | string | Cloudflare Zone ID |
| record_id | string | Cloudflare Record ID |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"message": "DNS 记录更新成功",
"full_name": "home.example.com",
"type": "A",
"old_ip": "1.2.3.4",
"new_ip": "5.6.7.8",
"changed": true
},
"tips": "极数本源 · https://apizero.cn"
}免责声明
Token 通过参数传入，仅用于本次请求转发到 Cloudflare 官方接口，平台不存储不记录。请使用最小权限的 Token（仅授予对应域名 DNS 编辑权限）。