Visão geral
O Register.gy é um registrador de domínios .gy credenciado. A plataforma para desenvolvedores oferece as mesmas ferramentas que os clientes usam na Área do cliente, para que um assistente ou um aplicativo possa:
- Verificar a disponibilidade de nomes .gy, .com.gy, .co.gy, .net.gy e .org.gy, com preço e link de registro. Não é preciso fazer login.
- Listar os domínios de um cliente e ler os registros DNS deles.
- Conectar um site: envie os registros que uma plataforma de sites mostra (Lovable, Bolt, Replit, v0, Netlify, Shopify…), receba uma pré-visualização e depois aplique. Toda alteração pode ser desfeita por 7 dias.
- Verificar se um site está no ar: visibilidade no DNS e https.
Por definição, a plataforma nunca altera registros de e-mail (MX) nem servidores DNS, não transfere domínios e não mexe em pagamentos. As alterações no nível do Registro são aplicadas pela equipe do Register.gy.
| URL base da API REST | https://register.gy/wp-json/rgy/v1 |
|---|---|
| Servidor MCP | https://register.gy/wp-json/rgy/v1/mcp |
| OpenAPI | https://register.gy/wp-json/rgy/v1/openapi.json |
| Metadados OAuth | https://register.gy/.well-known/oauth-authorization-server |
| Resumo para ferramentas de IA | https://register.gy/llms.txt |
Início rápido
1. Consultar um nome (sem chave)
curl "https://register.gy/wp-json/rgy/v1/availability?domain=mybakery.gy" 2. Criar uma chave de API
Entre na Área do cliente, abra API e assistentes de IA e clique em Criar chave de API. Ela é mostrada uma única vez.
3. Listar seus domínios
curl -H "Authorization: Bearer rgy_live_YOUR_KEY" https://register.gy/wp-json/rgy/v1/domains 4. Pré-visualize e depois conecte um site
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=…"}]}' Se a pré-visualização estiver correta, envie o mesmo corpo para /connect/apply. Desfaça com /connect/undo em até 7 dias.
Conectar um assistente de IA
O Register.gy tem um servidor MCP remoto (o modo padrão de os assistentes usarem ferramentas externas). Os assistentes que aceitam login abrem uma janela do Register.gy: o cliente informa o e-mail, digita o código de 6 dígitos que enviamos e aprova o que o assistente pode fazer.
Claude
Adicione um conector personalizado com este endereço e depois faça login:
https://register.gy/wp-json/rgy/v1/mcpChatGPT
Onde o ChatGPT permitir adicionar um conector ou app personalizado (modo desenvolvedor), use o mesmo endereço e escolha login com OAuth:
https://register.gy/wp-json/rgy/v1/mcpClaude Code
claude mcp add --transport http register-gy https://register.gy/wp-json/rgy/v1/mcpDepois, execute /mcp no Claude Code para fazer login. Ou dispense o login com uma chave: adicione --header "Authorization: Bearer rgy_live_YOUR_KEY".
Cursor e outros clientes MCP
{
"mcpServers": {
"register-gy": {
"url": "https://register.gy/wp-json/rgy/v1/mcp",
"headers": { "Authorization": "Bearer rgy_live_YOUR_KEY" }
}
}
}Os clientes que aceitam OAuth podem omitir headers e fazer login.
Depois, pergunte, por exemplo: "O mybakery.gy está disponível?" ou "Conecte meu site do Lovable ao mybakery.gy." O assistente mostra as alterações planejadas e pergunta antes de aplicá-las.
Endpoint público, só de pesquisa (sem login): https://register.gy/wp-json/rgy/v1/mcp/public
Autenticação
OAuth 2.1 (recomendado para assistentes e apps usados por outras pessoas)
- Fluxo de código de autorização com PKCE (somente S256). Clientes públicos e confidenciais.
- Registro dinâmico de clientes (RFC 7591) em
https://register.gy/oauth/register. As URIs de redirecionamento devem ser https, ou http em localhost. - Descoberta:
/.well-known/oauth-authorization-server(RFC 8414) e/.well-known/oauth-protected-resource(RFC 9728). O endpoint MCP responde a solicitações não autenticadas com401e um cabeçalhoWWW-Authenticateque aponta para os metadados do recurso. - Os tokens de acesso duram 1 hora; os tokens de atualização duram 30 dias e são trocados a cada uso. Reutilizar um token de atualização antigo encerra toda a conexão.
- Revogação:
https://register.gy/oauth/revoke(RFC 7009). Os clientes também podem desconectar apps na Área do cliente.
| Escopo | Permite |
|---|---|
domains:read | See your .gy domains and their DNS records |
websites:write | Connect your websites (change website records only, with 7-day undo) |
Chaves de API (seus próprios scripts e ferramentas)
Crie até 5 chaves na Área do cliente. Envie-as como Authorization: Bearer rgy_live_… ou X-API-Key: rgy_live_…. As chaves têm os dois escopos. Elas são armazenadas como hash, e o titular recebe um e-mail quando uma é criada.
Servidor MCP
Transporte Streamable HTTP, respostas JSON (sem fluxo de eventos), versões do protocolo 2025-06-18, 2025-03-26, 2024-11-05.
| Ferramenta | O que faz | Altera dados? |
|---|---|---|
search_domain | Check whether a .gy domain (.gy, .com.gy, .co.gy, .net.gy or .org.gy) is available at Register.gy, with the yearly price and a link to register it. | Não |
notify_when_registration_reopens | Use only when search_domain says new .gy registrations are paused. Adds the user to Register.gy's notify list: Register.gy checks the domain again and emails them a link to register it as soon as registration reopens (usually within about an hour). Only call with the user's permission and their own email address. | Sim, após confirmação |
list_my_domains | List the user's .gy domains at Register.gy, with expiry date and whether each can be connected to a website now. | Não |
get_dns_records | Show the current DNS records of one of the user's .gy domains. | Não |
connect_website | Point one of the user's .gy domains at their website by setting the DNS records their website builder (Lovable, Bolt, Replit, v0/Vercel, Netlify, Webflow, Shopify…) shows on its custom-domain screen. Use the builder's real values, never guesses. ALWAYS call with apply=false first and show the user the preview; call again with apply=true only after the user clearly confirms. Email (MX) and nameserver records are never changed. The change can be undone for 7 days. | Sim, após confirmação |
check_live | Check whether the website records of a .gy domain are visible on the internet and whether https works yet. | Não |
undo_last_change | Put back the website records that were in place before the last connect_website change on this domain (available for 7 days). Ask the user first. | Sim, após confirmação |
REST API
URL base https://register.gy/wp-json/rgy/v1. Entrada em JSON, saída em JSON. Os erros têm este formato: {"error":{"code":"not_found","message":"…"}}.
| Método | Caminho | Descrição | Autenticação |
|---|---|---|---|
| GET | /availability | Is a .gy domain available? | Nenhuma |
| GET | /status | Are .gy registrations open or paused right now? | Nenhuma |
| POST | /notify | While registrations are paused: email me when they reopen | Nenhuma |
| GET | /health | Service status for uptime monitors | Nenhuma |
| GET | /me | Who this key belongs to | Chave ou token |
| GET | /domains | Your .gy domains | Chave ou token |
| GET | /domains/{domain} | One domain | Chave ou token |
| GET | /domains/{domain}/records | Current DNS records | Chave ou token |
| POST | /domains/{domain}/connect/preview | Preview connecting a website (changes nothing) | Chave ou token |
| POST | /domains/{domain}/connect/apply | Connect a website (after the user confirms the preview) | Chave ou token |
| POST | /domains/{domain}/connect/undo | Undo the last connect | Chave ou token |
| GET | /domains/{domain}/live | Is the site live (DNS + https)? | Chave ou token |
| POST | /mcp | MCP endpoint for AI assistants (JSON-RPC 2.0, Streamable HTTP) | Chave ou token |
Corpo da solicitação de conexão
Uma lista de registros ou o texto bruto que sua plataforma mostra (uma tabela ou lista). Só A, AAAA, CNAME (ALIAS) e TXT são configurados; qualquer outro tipo é listado em skipped com o motivo.
{
"records": [
{ "type": "A", "name": "@", "value": "185.158.133.1" },
{ "type": "CNAME", "name": "www", "value": "mysite.netlify.app" }
]
} Limites e erros
| Solicitações | 300 por chave ou conexão a cada 10 minutos |
|---|---|
| Alterações | 60 a cada 10 minutos por cliente (compartilhado com a Área do cliente) |
| Disponibilidade | 30 consultas por minuto por endereço IP |
| Registros por conexão | 15 |
| Status | Significado |
|---|---|
| 400 | Solicitação inválida (a mensagem diz o que corrigir) |
| 401 | Chave ou token ausente, inválido ou expirado |
| 403 | Não permitido (por exemplo, uma conexão somente leitura tentando alterar registros, ou um domínio gerenciado pela nossa equipe) |
| 404 | Não pertence a esta conta, ou endpoint desconhecido |
| 429 | Solicitações demais; aguarde e tente novamente |
| 503 | Uma dependência (o DNS ou a verificação de disponibilidade) não está respondendo; tente novamente mais tarde |
Segurança
- Chaves e tokens são armazenados apenas como hashes SHA-256. Os códigos de login são de uso único, expiram em 10 minutos e têm limite de tentativas.
- Cada chave ou conexão só vê os domínios do cliente que a criou.
- Toda alteração feita pela API é registrada e pode ser desfeita por 7 dias. Os registros do site são configurados somente como DNS para que as plataformas possam emitir seus certificados https.
- Encontrou um problema de segurança? Escreva para [email protected] com "Security" no assunto. Dê-nos a chance de corrigi-lo antes de contar a outras pessoas.
Registro de alterações
- 8 de outubro de 2026 Login com OAuth 2.1 (PKCE, registro dinâmico de clientes, rotação de tokens de atualização), apps conectados na Área do cliente, endpoint MCP público só de pesquisa.
- 8 de outubro de 2026 Lançamento da API REST e do servidor MCP: disponibilidade, domínios, registros, conexão com pré-visualização/aplicação/reversão, verificação de site no ar. Chaves de API na Área do cliente.
Suporte e termos
Dúvidas, ideias ou propostas de parceria: [email protected] ou +592-623-1721.
O uso da API é regido pela nossa política de privacidade. Termos específicos da API estão sendo finalizados.