domains

域名

使用公开的 Registrar API 进行未认证的查询。使用已安装的 Vercel CLI 执行账户和项目操作，或使用 REST API 进行结构化自动化。vc 和 vercel 等效。

域名注册、Vercel 团队所有权、项目分配和权威 DNS 是彼此独立的。连接已拥有的域名不需要购买或转移其注册。

先搜索，再索取凭据

从一次请求同时返回可用性和价格，开始精确名称查询：

curl --fail-with-body --silent --show-error \
  https://api.vercel.com/v1/registrar/domains/search \
  --header 'Content-Type: application/json' \
  --data '{"domains":["example.com","example.dev","example.app"]}'

每次请求发送 1–200 个精确域名。端点会检查提供的名称，不会生成建议。根据用户的命名约束生成候选名称，然后分批查询。无需 Vercel 账户、令牌或项目链接。

结果保留输入顺序。可用的条目包含 domain、available、years、price、renewalPrice 和 premium；价格以美元计，适用于返回的期限。报告注册和续费费用时，注明对应期限，并标记高级域名。available: false 表示不可用，或无法确认可用性；这并不能证明该名称已被他人拥有。缺失的价格表示未知，而不是零。可用性和报价在购买前可能发生变化。

对于关键词／顶级域名查询，较新的 CLI 可以生成候选名称：

vercel domains search acme --tld com --tld dev --available --format=json
vercel domains check example.com example.dev --format=json
vercel domains price example.com --format=json

请根据已安装的版本检查 vercel domains --help 和所选子命令的 --help。如果无法查询，或 CLI 要求登录，请直接使用公开端点。CLI 的 search 接受关键词；API 的 search 接受精确名称。不要混用这两种输入格式。

连接并诊断现有域名

对于需要认证的操作，请检查 vercel whoami，并在选择团队时使用 --scope <team>。更改域名之前，先确定目标项目。

vercel domains ls --scope my-team
vercel domains inspect example.com --scope my-team
vercel domains add example.com my-project --scope my-team
vercel domains verify example.com --project my-project --format=json --scope my-team

使用该域名和项目返回的实际预期 DNS 记录和所有权验证值。不要硬编码通用 A 记录或 CNAME 目标。在权威 DNS 提供商处配置记录；vercel dns 只会更改 Vercel DNS。保留无关记录，尤其是 MX 和电子邮件验证 TXT 记录。更改名称服务器时，必须一并迁移区域所需的记录。

任务	CLI
列出 DNS 记录	vercel dns ls example.com
检查记录	vercel dns inspect <record-id> --format=json
添加所需的 TXT 记录	vercel dns add example.com <record-name> TXT <record-value>
更新现有记录	vercel dns update <record-id> --value <record-value>
移除指定记录	vercel dns rm <record-id>
转移团队所有权	vercel domains move example.com <destination-team>
移除团队所有权	vercel domains rm example.com

更改后，重新运行 domains verify，并检查 DNS 传播和 HTTPS。即使验证以非零状态退出，也可能会返回说明不匹配情况的有用 JSON。DNS 写入被接受，并不能证明 DNS 已传播或证书已就绪。domains add --force 可能会将域名从其他项目解绑；仅在确实需要重新分配时使用。移除团队所有权并不等于转移注册商或取消域名注册。

购买、转入和续费

仅在已获得明确授权，且授权涵盖具体域名、期限、价格和续费偏好时，才使用该授权。如果这些选项尚未确定，请先准备当前报价再进行询问。不得将查询请求视为购买许可。使用用户提供的真实注册人信息，并确保令牌、联系信息和转移码不会出现在日志或已提交的文件中。

任务	CLI
注册域名	vercel domains buy example.com
从其他注册商转入	vercel domains transfer-in example.com
续订注册	vercel domains renew example.com
启用或停用自动续费	vercel domains auto-renew example.com on / off

转入流程可能需要交互式输入。使用 Vercel CLI 63.1.0+ 时，domains buy 和 domains renew 无需提示即可运行：传入 --scope <team> --json，且不带 --amount，即可获取价格、期限和下一条命令，而不会产生扣款；获得用户批准后，运行返回的命令并传入 --amount <approved-price-in-USD>（购买还需要注册人标志，并且必须且只能指定 --auto-renew / --no-auto-renew 其中一个）。CLI 不会重试扣款；如果结果不确定，请在重试前运行 domains inspect。对于较旧版本的 CLI，请使用带有所需负载的 Registrar API，不要臆造 CLI 标志。在 Vercel 团队之间转移域名时，应使用 domains move，而不是 transfer-in。

Registrar API

基础 URL：https://api.vercel.com。构造变更请求前，请查阅实时 OpenAPI 架构，了解所选操作的请求和响应字段。

公开查询

请使用 Registrar API 参考查询公开的 TLD 元数据、指定期限的域名价格、可用性和联系信息要求。这些操作无需身份验证。批量查询可用性和价格的调用支持 1–50 个域名；搜索支持 1–200 个域名。

TLD 基础价格不包含溢价域名的报价。请使用与所需期限对应的具体域名价格；价格端点返回 purchasePrice，而搜索返回 price。某些价格字段可能是字符串，而非数值报价；请勿将其作为 expectedPrice 提交。

经过身份验证的操作

发送 Authorization: Bearer <token>，并使用 ?teamId=<team-id> 指定目标团队。对于 JSON 请求体，请使用 Content-Type: application/json。重复使用安全可用的令牌；对于公开发现操作，不要索要令牌。

对于购买、转移、续订、自动续订、名称服务器和联系人验证，请使用实时架构中选定的操作。使用 GET /v1/registrar/orders/{orderId} 检查异步结果。空的名称服务器数组表示选择 Vercel 默认值；购买后的前 30 分钟内无法进行联系人验证。

购买时，获取联系人架构，并通过购买请求负载的 contactInformation.additional 字段提供 TLD 特定的必填值。转移时，只能使用该操作实时架构接受的联系人字段；它不接受仅用于购买的 additional 字段。购买 Punycode 域名需要使用受支持的 languageCode；请检查 TLD 元数据。先查询确切操作和期限的报价，再将该数字报价用作 expectedPrice。如果价格不匹配，请根据用户授权的支出重新评估，而不要默默接受涨价。

购买、续订和转移可能会异步完成。保存返回的订单 ID，检查订单及每个域名的状态，并如实报告待处理或失败的结果。如果提交超时，请先核对订单状态，再重新提交扣款请求。完成后或失败后停止轮询；如果在有限次数的检查后仍处于待处理状态，请返回订单 ID 和下一步状态检查操作。完成任何必需的注册人电子邮件验证。

注册商操作请使用 /v1/registrar/*，而不要使用已弃用的旧版购买、价格、可用性或转移端点。现有的项目域名和 DNS API 用途各不相同；注册商 API 不会取代它们。