Cloudflare DNS API 初窥

Fri, 12 Jan 2024 12:22:52 +0800

Cloudflare 作为世界上最大的互联网慈善组织，为开发者提供了极其完整的 API 支持。本文关注于 Cloudflare 的 DNS API 部分。

申请 API 令牌(Token)

这是 API 使用过程中唯一图形化的部分了。我们要在用户 API 令牌创建一个令牌。对于我们要操作的 DNS，可以选择编辑区域 DNS 模板，然后填入我们要操作的二级域名（和 IP 地址白名单）。为了最小权限原理，建议填写白名单。

然后就生成了我们的 API Token！注意保存以及保存的安全性，因为离开页面后再也见不到它啦。如果弄丢了只能重新生成部署了。

建议在对应服务器上明文储存，反正有 ssh 帮你拦着风险。

然后就可以尝试验证一下 Token。

curl "https://api.cloudflare.com/client/v4/user/tokens/verify" \
     -H "Authorization: Bearer <API_TOKEN>"

正常情况下应当返回

{
  "result": {
    "id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "active"
  },
  "success": true,
  "errors": [],
  "messages": [
    {
      "code": 10000,
      "message": "This API Token is valid and active",
      "type": null
    }
  ]
}

DNS Record API

Cloudflare 的 API 采用 RESTful 风格，默认基于 JSON (Content-Type: application/json) 传递数据。

Cloudflare on wsmの随记

Cloudflare DNS API 初窥

申请 API 令牌(Token)

DNS Record API