在你构建的任何地方注册域名:Cloudflare Registrar API 进入 beta

原文:Register domains wherever you build: Cloudflare Registrar API now in beta Source: https://blog.cloudflare.com/registrar-api-beta/

2026-04-15

今天我们启动 Cloudflare Registrar 的下一篇章:Registrar API 进入 beta。

Registrar API 让以编程方式搜索域名、查询可用性并注册成为可能。现在,在一个想法刚开始变得真实的瞬间买下域名,不再需要把你拽出 agentic 工作流。

Registrar API 一直是使用 Cloudflare 的开发者最明确的需求之一。随着越来越多的 agentic 工作流转移到编辑器、终端和 agent 驱动的工具里,域名注册成了显而易见有待补齐的缺口。

七年前我们推出 Cloudflare Registrar 时,想法很简单:域名应该按成本价提供,不加价、不耍花招。从那时起,Cloudflare Registrar 已经成为全世界增长最快的注册商之一,因为越来越多人选择 Cloudflare 作为自己下一个项目的落脚地。

^{在 AI 代码编辑器内提示一个 agent 来生成名字想法、搜索、检查并购买一个域名。}

为 agents 与自动化而生

Registrar API 设计用于在软件已经被构建的任何地方良好工作:在编辑器内、部署管道、后端服务以及 agent 驱动的工作流中。

工作流刻意做到简单且对机器友好。Search 返回候选名字。Check 返回实时可用性和价格。Register 接收一个最小化的请求并返回一个 workflow 形态的响应,可以立即完成,也可以在耗时较长时进行轮询。这让传统 API 客户端和代表用户行动的 AI agents 都能直观使用。

实际上,这意味着一个 agent 可以协助完成完整流程:建议名字,确认哪一个真的可注册,展示价格供批准,然后完成购买,而不需要把用户从他们正在使用的工具里拽出来。

Registrar API

这个 Registrar API 的首发版本核心做三件事:

Search 域名
Check 可用性
Register 域名

关于一组精选的热门 TLD,可参考 Registrar API 文档。在受支持时,premium 域名也可以注册,但需要显式确认费用。

Registrar API 是完整 Cloudflare API 的一部分,这意味着 agents 今天就已经可以通过 Cloudflare MCP 访问它。它不需要单独的集成或自定义工具定义。在 Cursor、Claude Code 或任何兼容 MCP 的环境中工作的 agent,都可以使用覆盖整个 Cloudflare API 表面的相同 search() 和 execute() 模式来发现并调用 Registrar 端点。一旦该 API 进入我们的 spec,它就已经为 agents 准备好了。

实际看起来是这样:

你正在自己最爱的 AI 代码编辑器里构建一个新项目。脚手架搭到一半时,你问你的 agent:“给这个项目找一个不错的 .dev 域名并注册它。”

agent 基于你的项目搜索候选名字。它针对你选中的那个查询实时可用性,并确认价格。你说好。它使用账户默认的联系信息和支付方式自动注册域名。等你读完响应,域名已经注册好,WHOIS 隐私也已开启。

三次 API 调用。几秒钟。

代码看起来是这样:

第 1 步:`Search` 域名

使用 search 端点提交一个域名查询,带或不带域名后缀都可以。

async () => {
  return cloudflare.request({
    method: "GET",
    path: `/accounts/${accountId}/registrar/domain-search`,
    query: { q: "acme corp", limit: 3 },
  });
}

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "acmecorp.com",
        "registrable": true,
        "tier": "standard",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        }
      },
      {
        "name": "acmecorp.dev",
        "registrable": true,
        "tier": "standard",
        "pricing": {
          "currency": "USD",
          "registration_cost": "10.11",
          "renewal_cost": "10.11"
        }
      },
      {
        "name": "acmecorp.app",
        "registrable": true,
        "tier": "standard",
        "pricing": {
          "currency": "USD",
          "registration_cost": "11.00",
          "renewal_cost": "11.00"
        }
      }
    ]
  }
}

第 2 步:`Check` 可用性与价格

搜索结果速度快但不具权威性;它们基于缓存数据,而对热门名字而言,可用性可能在几秒内就发生变化。Check 直接向注册局查询。在注册前立即调用它,并把它返回的价格作为权威来源。

async () => {
  return cloudflare.request({
    method: "POST",
    path: `/accounts/${accountId}/registrar/domain-check`,
    body: { domains: ["acmecorp.dev"] },
  });
}

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "acmecorp.dev",
        "registrable": true,
        "tier": "standard",
        "pricing": {
          "currency": "USD",
          "registration_cost": "10.11",
          "renewal_cost": "10.11"
        }
      }
    ]
  }
}

第 3 步:`Register` 域名

唯一必填字段是域名。WHOIS 隐私保护默认开启,不额外收费。如果你的账户有默认的注册联系人,API 会自动使用它;否则你可以在请求中内联提供联系信息。系统会自动使用你的默认支付方式。

async () => {
  return cloudflare.request({
    method: "POST",
    path: `/accounts/${accountId}/registrar/registrations`,
    body: { domain_name: "acmecorp.dev" },
  });
}

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "domain_name": "acmecorp.dev",
    "state": "succeeded",
    "completed": true,
    "created_at": "2025-10-27T10:00:00Z",
    "updated_at": "2025-10-27T10:00:03Z",
    "context": {
      "registration": {
        "domain_name": "acmecorp.dev",
        "status": "active",
        "created_at": "2025-10-27T10:00:00Z",
        "expires_at": "2026-10-27T10:00:00Z",
        "auto_renew": true,
        "privacy_enabled": true,
        "locked": true
      }
    },
    "links": {
      "self": "/accounts/abc/registrar/registrations/acmecorp.dev/registration-status",
      "resource": "/accounts/abc/registrar/registrations/acmecorp.dev"
    }
  }
}

注册通常在几秒内同步完成。如果耗时较长,API 会返回 202 Accepted,并附上一个 workflow URL 供轮询。无论哪种情况,响应形态相同,无需特殊处理。对于 premium 域名,Check 响应会返回注册局设定的精确价格,Register 请求把它回传作为显式的费用确认。

阅读 Registrar API 指南
查看 API 参考

如果有什么缺失、某个工作流中断,或者你正构建更大的平台用例,请告诉我们。我们正在迅速扩展 API 的功能以支持域名续费、转移以及更多。

我们迫不及待想看到你构建什么!

特别感谢 Lucy Dryaeva 与 Fred Pinto 在交付 Registrar API beta 上做出的宝贵贡献。

从零构建 Cloudflare Agent

在你构建的任何地方注册域名:Cloudflare Registrar API 进入 beta

为 agents 与自动化而生

Registrar API

第 1 步:`Search` 域名

第 2 步:`Check` 可用性与价格

第 3 步:`Register` 域名

关于 agents 与不可退款购买的说明

Cloudflare 为何能用不同的方式做这件事

API 的下一步

今天就开始构建

Keyboard shortcuts

从零构建 Cloudflare Agent