Esta página é exibida no idioma do seu dispositivo.Ver em inglês

Desenvolvedores

Crie com o Register.gy

Permita que assistentes de IA e seus próprios aplicativos consultem domínios .gy e os conectem a sites. Uma API REST, um servidor MCP para Claude, ChatGPT e Cursor, e login com OAuth. Grátis para todo cliente do Register.gy.

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 RESThttps://register.gy/wp-json/rgy/v1
Servidor MCPhttps://register.gy/wp-json/rgy/v1/mcp
OpenAPIhttps://register.gy/wp-json/rgy/v1/openapi.json
Metadados OAuthhttps://register.gy/.well-known/oauth-authorization-server
Resumo para ferramentas de IAhttps://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/mcp

ChatGPT

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/mcp

Claude Code

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

Depois, 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 com 401 e um cabeçalho WWW-Authenticate que 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.
EscopoPermite
domains:readSee your .gy domains and their DNS records
websites:writeConnect 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.

FerramentaO que fazAltera dados?
search_domainCheck 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_reopensUse 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_domainsList 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_recordsShow the current DNS records of one of the user's .gy domains.Não
connect_websitePoint 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_liveCheck whether the website records of a .gy domain are visible on the internet and whether https works yet.Não
undo_last_changePut 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étodoCaminhoDescriçãoAutenticação
GET/availabilityIs a .gy domain available?Nenhuma
GET/statusAre .gy registrations open or paused right now?Nenhuma
POST/notifyWhile registrations are paused: email me when they reopenNenhuma
GET/healthService status for uptime monitorsNenhuma
GET/meWho this key belongs toChave ou token
GET/domainsYour .gy domainsChave ou token
GET/domains/{domain}One domainChave ou token
GET/domains/{domain}/recordsCurrent DNS recordsChave ou token
POST/domains/{domain}/connect/previewPreview connecting a website (changes nothing)Chave ou token
POST/domains/{domain}/connect/applyConnect a website (after the user confirms the preview)Chave ou token
POST/domains/{domain}/connect/undoUndo the last connectChave ou token
GET/domains/{domain}/liveIs the site live (DNS + https)?Chave ou token
POST/mcpMCP 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ções300 por chave ou conexão a cada 10 minutos
Alterações60 a cada 10 minutos por cliente (compartilhado com a Área do cliente)
Disponibilidade30 consultas por minuto por endereço IP
Registros por conexão15
StatusSignificado
400Solicitação inválida (a mensagem diz o que corrigir)
401Chave ou token ausente, inválido ou expirado
403Não permitido (por exemplo, uma conexão somente leitura tentando alterar registros, ou um domínio gerenciado pela nossa equipe)
404Não pertence a esta conta, ou endpoint desconhecido
429Solicitações demais; aguarde e tente novamente
503Uma 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.