Cloudflare推出域名注册API测试版，支持程序化操作
Cloudflare AI··作者 Carlos Armada
关键信息
该API支持搜索、检查和注册三大核心功能，初始支持热门顶级域名，提供实时定价，并支持高级域名（需明确费用确认）。它属于Cloudflare完整API套件的一部分，可通过MCP直接访问，无需额外配置。
资讯摘要
Cloudflare发布了测试版域名注册API，允许开发者在现有开发环境中自动完成域名搜索、检查可用性和注册操作。这消除了用户必须离开AI代码编辑器或部署流水线才能购买域名的麻烦。该API专为AI代理工作流设计，使AI代理能自主建议名称、确认是否可注册、获取价格并在用户授权后完成购买。
它无缝集成于Cloudflare的完整API生态中，开发者可在Cursor或Claude Code等工具中通过标准的`search()`和`execute()`模式调用。整个流程只需三步API调用，耗时约几秒。高级域名也受支持，但需用户明确同意后方可购买。
资讯正文
今天，我们推出了 Cloudflare 注册商的下一章：
注册商 API（Beta 版）
注册商 API 让开发者能够程序化地搜索域名、检查可用性并完成注册。现在，当一个想法开始变得真实时，你无需离开当前的工作流就能立即购买域名。
对于使用 Cloudflare 的开发者来说，注册商 API 是最明确的需求之一。随着越来越多的代理工作流转移到编辑器、终端和代理驱动的工具中，域名注册成了亟需填补的空白。
七年前，我们推出 Cloudflare 注册商时，初衷很简单：域名应该按成本价提供，不加价、不玩套路。此后，Cloudflare 注册商已成为全球增长最快的注册商之一，越来越多的人选择它作为构建下一个项目的起点。
在 AI 代码编辑器中提示代理生成名称创意，并搜索、检查、购买域名。
专为代理和自动化设计
注册商 API 的设计目标是在软件已有的开发环境中无缝运行：无论是编辑器内部、部署流水线、后端服务还是代理驱动的工作流。
整个流程被有意设计得简单且对机器友好。
搜索返回候选名称。
检查返回实时可用性和价格。
注册接收一个最小请求，并返回结构化的响应，可立即完成，也可轮询等待较长时间的任务结果。这使得传统 API 客户端和代表用户行动的 AI 代理都能轻松使用。
实际上，这意味着代理可以完整处理整个流程：建议名称、确认哪个实际可注册、展示价格供批准，然后自动完成购买，而无需让用户离开正在使用的工具。
注册商 API 的核心功能
本次发布的注册商 API 主要实现三项基础功能：
搜索域名
检查域名可用性
目前支持一组精选的热门顶级域名（TLD），详见注册商 API 文档。当支持时，也可以注册精品域名，但需要用户明确确认额外费用。
注册商 API 是 Cloudflare 全套 API 的一部分，因此代理已经可以通过 Cloudflare MCP 直接访问它，无需单独集成或自定义工具定义。在 Cursor、Claude Code 或任何兼容 MCP 的环境中工作的代理，都可以使用相同的 search() 和 execute() 模式发现并调用注册商端点，覆盖整个 Cloudflare API 表面。一旦该 API 被纳入我们的规范，它就已准备好供代理使用。
实际应用场景示例
你在最喜欢的 AI 代码编辑器中开发新项目。在搭建过程中，你让代理帮忙：“帮我找一个适合这个项目的 .dev 域名并注册下来。”
代理根据你的项目搜索候选名称，检查你选定的那个域名的实时可用性并确认价格。你同意后，它会自动使用你账户默认的联系信息和付款方式注册域名。等你读完响应时，域名已经注册成功，隐私保护也已启用。
三个 API 调用。几秒钟。
代码中的样子
第一步：搜索域名
使用 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"
}
}
}
}
第二步：检查可用性和价格
搜索结果很快，但不是权威的；它们基于缓存数据，热门域名的可用性可能在几秒内发生变化。
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"
}
}
}
}
第三步：注册域名
唯一必需的字段是域名名称。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 会返回 HTTP 202 Accepted 和一个工作流 URL 供轮询。无论哪种情况，响应结构都相同，无需特殊处理。对于高端域名，Check 响应会返回注册局设定的确切价格，而注册请求会将该价格回传作为明确的费用确认。
关于代理和不可退款购买的一点说明
当代理代表您注册域名时，会使用您的默认支付方式扣费。域名注册完成后不可退款。设计良好的代理流程应在调用注册端点之前，向用户确认域名名称和价格。
检查（Check）步骤的存在正是为了明确且无歧义地完成这一步确认。API 提供了构建正确流程所需的工具；但如何实现这一功能的责任在于您的代理逻辑中。
默认情况下，我们的 API 文档明确要求代理在调用注册 API 时必须获取用户的授权。
然而，最终决定是否购买域名的责任仍在于人类设计的代理流程，确保不会在未经您同意的情况下擅自购买。
为什么 Cloudflare 能够做到不同
与许多正在添加域名工作流的开发者平台不同，Cloudflare 自己运营注册商服务。这意味着项目构建和部署的同一平台也能搜索、注册和管理域名——无需额外加价。
按成本定价是 Cloudflare 注册商模型的核心。我们收取的价格完全等于注册机构的费用。无论您是通过仪表板注册域名、直接调用 API，还是让代理代为注册，价格都保持一致。
API 的下一步方向
此次测试版主要聚焦于域名生命周期中的第一个关键环节：搜索、检查和注册。我们正在积极扩展 API 功能，覆盖更多注册商的核心体验，使域名在购买之后也能通过程序化方式进行管理，而不仅仅是在创建时。这将包括转移、续费、联系人信息更新等生命周期元素。
API 是迈向更广泛“注册商即服务”产品的重要一步。该服务目前正在开发中，目标是在今年晚些时候推出。随着 API 的不断扩展，网站构建器、托管服务商、AI 产品以及其他多租户应用平台将能够将域名注册整合进自己的用户体验中。用户可以在不离开当前服务或代理驱动的工作流的情况下，搜索域名、购买并配置它。
现在就开始构建吧
Registrar API 的存在是因为开发者们提出了需求。如今它已作为测试版发布，我们非常期待看到您打造的作品，欢迎在 Cloudflare 社区、X 或 Discord 上分享。
开始前请先：
阅读 Registrar API 指南
查看 API 参考文档
如果您发现缺失的功能、某个流程中断，或者正在构建面向更大平台场景的用例，请告诉我们。我们正快速推进 API 功能扩展，以支持域名续费、转移等功能。
我们迫不及待想看看你们创造什么！
特别感谢 Lucy Dryaeva 和 Fred Pinto 对 Registrar API 测试版交付所做出的重要贡献。
来源与参考
收录于 2026-04-16