基于 Register.gy 构建

概览

Register.gy 是经认可的 .gy 域名注册商。开发者平台提供与客户在客户中心使用的相同工具，因此助手或应用可以：

• 查询 .gy、.com.gy、.co.gy、.net.gy 和 .org.gy 域名是否可注册，并获取价格和注册链接。无需登录。
• 列出客户的域名并读取其 DNS 记录。
• 连接网站：发送建站工具显示的记录（Lovable、Bolt、Replit、v0、Netlify、Shopify 等），获取预览，然后应用。每次更改均可在 7 天内撤销。
• 检查网站是否已上线：DNS 可见性和 https。

按照设计，该平台从不更改邮件（MX）记录或域名服务器，不转移域名，也不涉及付款。注册局层面的更改由 Register.gy 团队执行。

快速入门

1. 查询域名（无需密钥）

复制curl "https://register.gy/wp-json/rgy/v1/availability?domain=mybakery.gy"

2. 创建 API 密钥

登录客户中心，打开 API & AI 助手，然后点击创建 API 密钥。密钥只显示一次。

3. 列出您的域名

复制curl -H "Authorization: Bearer rgy_live_YOUR_KEY" https://register.gy/wp-json/rgy/v1/domains

4. 先预览，再连接网站

复制curl -X POST https://register.gy/wp-json/rgy/v1/domains/mybakery.gy/connect/preview \
  -H "Authorization: Bearer rgy_live_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"records":[{"type":"A","name":"@","value":"185.158.133.1"},{"type":"TXT","name":"_lovable","value":"lovable_verify=…"}]}'

如果预览无误，将相同的请求体发送到 /connect/apply。7 天内可通过 /connect/undo 撤销。

连接 AI 助手

Register.gy 运行一个远程 MCP 服务器（助手使用外部工具的标准方式）。支持登录的助手会打开一个 Register.gy 窗口：客户输入邮箱，填写我们发送的 6 位验证码，然后批准助手可以执行的操作。

复制https://register.gy/wp-json/rgy/v1/mcp

复制https://register.gy/wp-json/rgy/v1/mcp

复制claude mcp add --transport http register-gy https://register.gy/wp-json/rgy/v1/mcp

复制{
  "mcpServers": {
    "register-gy": {
      "url": "https://register.gy/wp-json/rgy/v1/mcp",
      "headers": { "Authorization": "Bearer rgy_live_YOUR_KEY" }
    }
  }
}

然后可以这样提问：“mybakery.gy 可以注册吗？”或“把我的 Lovable 网站连接到 mybakery.gy。”助手会显示计划进行的更改，并在应用前征求您的同意。

公开的、仅限搜索的接口（无需登录）：https://register.gy/wp-json/rgy/v1/mcp/public

身份验证

OAuth 2.1（推荐用于供他人使用的助手和应用）

• 授权码流程，使用 PKCE（仅限 S256）。支持公开客户端和机密客户端。
• 动态客户端注册（RFC 7591），地址为 https://register.gy/oauth/register。重定向 URI 必须使用 https，或在 localhost 上使用 http。
• 发现：/.well-known/oauth-authorization-server（RFC 8414）和 /.well-known/oauth-protected-resource（RFC 9728）。MCP 接口会对未经身份验证的请求返回 401，并附带指向资源元数据的 WWW-Authenticate 标头。
• 访问令牌有效期为 1 小时；刷新令牌有效期为 30 天，且每次使用都会轮换。重复使用旧的刷新令牌将终止整个连接。
• 撤销：https://register.gy/oauth/revoke（RFC 7009）。客户也可以在客户中心断开应用连接。

API 密钥（用于您自己的脚本和工具）

可在客户中心创建最多 5 个密钥。以 Authorization: Bearer rgy_live_… 或 X-API-Key: rgy_live_… 的形式发送。密钥同时具有两种权限范围。密钥以哈希形式存储，每次创建密钥时都会发邮件通知所有者。

MCP 服务器

Streamable HTTP 传输，JSON 响应（无事件流），协议版本 2025-06-18, 2025-03-26, 2024-11-05。

REST API

基础 URL https://register.gy/wp-json/rgy/v1。输入和输出均为 JSON。错误格式如 {"error":{"code":"not_found","message":"…"}}。

连接请求体

可以是记录列表，也可以是建站工具显示的原始文本（表格或列表）。仅设置 A、AAAA、CNAME（ALIAS）和 TXT 记录；其他记录会列在 skipped 下并附上原因。

复制{
  "records": [
    { "type": "A", "name": "@", "value": "185.158.133.1" },
    { "type": "CNAME", "name": "www", "value": "mysite.netlify.app" }
  ]
}

限制与错误

安全

• 密钥和令牌仅以 SHA-256 哈希形式存储。登录验证码一次性有效，10 分钟后过期，并有频率限制。
• 每个密钥或连接只能看到创建它的客户的域名。
• 通过 API 进行的每次更改都会被记录，并可在 7 天内撤销。网站记录设为仅 DNS 模式，以便建站工具签发 https 证书。
• 发现安全问题？请发邮件至 [email protected]，主题中注明“Security”。在告知他人之前，请给我们修复的机会。

更新日志

• 2026年10月8日 OAuth 2.1 登录（PKCE、动态客户端注册、刷新令牌轮换），客户中心中的已连接应用，公开的仅限搜索 MCP 接口。
• 2026年10月8日 REST API 和 MCP 服务器上线：可注册查询、域名、记录、连接预览/应用/撤销、上线检查。客户中心提供 API 密钥。

支持与条款

问题、建议或合作请求：[email protected] 或 +592-623-1721。

API 的使用受我们的隐私政策约束。专门的 API 条款正在定稿中。