Black Friday: adicione saldo e ganhe o dobro em crédito, até $50 grátis ($25 → $50, $50 → $100). Use para tudo: domínios, hospedagem, e-mail. Código: BLACKFRIDAY2026 Receba 2x o crédito →

Dê uma só chave à sua IA. Ela trata dos seus domínios.

A API da NameOcean permite que qualquer programa, ou qualquer assistente de IA, faça o que você faz no painel: pesquisar e registar domínios, alterar nameservers, editar registos DNS, emitir certificados SSL, abrir portas e associar domínios aos seus servidores.

  1. 1

    Criar uma chave

    Abra Painel → Chaves de API, escolha o que a chave pode fazer e copie-a.

  2. 2

    Entregue à sua IA

    Cole o prompt abaixo no Claude, no ChatGPT ou no Cursor, juntamente com a sua chave.

  3. 3

    Peça em linguagem simples

    "Aponte blog.example.com para 203.0.113.10 e ative o SSL."

Prompt para o seu assistente de IA

Pode gerir os meus domínios com a API da NameOcean. Leia https://nameocean.net/llms.txt para saber como funciona. A minha chave de API é: [cole aqui a sua chave]. Pergunte-me sempre antes de qualquer ação que implique custos.

Dê a cada ferramenta a sua própria chave, apenas com as permissões de que ela precisa. Se uma chave vazar, exclua-a no painel; as outras continuam funcionando.

Ligue o Claude Code, o Cursor ou qualquer cliente MCP

A NameOcean disponibiliza um servidor MCP remoto. Adicione-o uma vez e a sua IA poderá gerir DNS, SSL, servidores, portas e associações de domínios. Inicia sessão no navegador; sem chave de API para colar e nada para instalar.

Claude Code
$ claude mcp add --transport http nameocean https://nameocean.net/mcp

Claude Desktop e claude.ai: Definições → Conectores → Adicionar conector personalizado, URL https://nameocean.net/mcp. Cursor, VS Code, OpenCode e outros: adicione um servidor MCP HTTP com o mesmo URL. Os clientes sem OAuth podem enviar Authorization: Bearer <API key>.

As chaves de API e as ligações de aplicações exigem início de sessão em dois passos na sua conta. Ativar

O servidor MCP não pode registar nem renovar domínios nem adicionar crédito, e só cria um servidor pago depois de aceitar o preço. Pode desligar aplicações a qualquer momento em Painel → Aplicações ligadas.

Configuração para cada cliente e todas as ferramentas →

Linha de comandos

A CLI nameocean faz o mesmo a partir do seu terminal e dos seus scripts, e o comando nameocean mcp install conecta o Claude Code, o Cursor, o OpenCode e o VS Code para você.

nameocean
$ curl -fsSL https://nameocean.net/install.sh | sh
$ nameocean login
$ nameocean dns add example.com A @ 203.0.113.10

Opções de instalação e todos os comandos →

Webhooks

Receba um POST assinado quando um domínio for registrado ou estiver prestes a expirar, um registro DNS mudar ou um certificado for emitido, em vez de consultar a API repetidamente.

Eventos, payloads e verificação de assinatura →

Email

Envie e-mails transacionais a partir do seu próprio domínio com eventos de entrega, crie caixas de correio, aliases e listas de distribuição, ative o reencaminhamento gratuito para domínios registados aqui e receba o correio recebido no seu endpoint em JSON.

Guia da API de e-mail →

Autenticação

Envie a sua chave no cabeçalho Authorization de cada pedido. As respostas são em JSON. O limite é de 120 pedidos por minuto.

curl
$ curl https://nameocean.net/api/v1/account \
    -H "Authorization: Bearer $NAMEOCEAN_API_KEY"

{"email": "you@example.com", "credit": "42.00", "currency": "USD", "domains": 3, "dns_zones": 3}

Permissões da chave (escopos)

Crie quantas chaves precisar em Painel → Chaves de API, cada uma apenas com as permissões de que sua ferramenta precisa, uma data de expiração opcional e uma lista opcional de IPs permitidos. A chave é exibida uma única vez; a NameOcean guarda apenas sua impressão digital.

Uma chave também pode ser limitada a alguns dos seus domínios. Nesse caso, funciona apenas nos endpoints desses domínios (DNS, SSL, definições do domínio, o respetivo email e reencaminhamento), vê apenas esses domínios em GET /dns e recebe 403 domain_not_allowed em qualquer outro lugar, incluindo servidores, faturação e os seus outros domínios. Utilize uma para tarefas de CI e ferramentas como certbot, octoDNS ou DNSControl.

account:readE-mail e crédito da conta
domains:readListar domínios, verificar disponibilidade e preço
domains:writeAlterar renovação automática, bloqueio e nameservers; ler o código de transferência
dns:readListar zonas e registros DNS
dns:writeCriar zonas; adicionar, alterar e excluir registros
ssl:readStatus do certificado
ssl:writeEmitir certificados, alterar renovação automática
servers:readServidores de aplicação, suas portas e domínios
servers:writeAbrir e fechar portas, vincular e desvincular domínios
email:readDomínios de e-mail, caixas de correio, aliases, reencaminhamento e o respetivo registo
email:writeAdicione e elimine caixas de correio, aliases e listas; defina palavras-passe; ative e desative o reencaminhamento
email:sendEnviar e-mails a partir das suas caixas de correio (POST /email/send)
monitors:readMonitores de disponibilidade, o seu estado e incidentes
monitors:writeAdicionar, alterar, pausar e eliminar monitores de disponibilidade
webhooks:readEndpoints de webhook e suas entregas
webhooks:writeAdicione, altere e exclua endpoints de webhook, envie testes e reenvie entregas
billing:writeRegistrar e renovar domínios (usa o crédito da conta)

GET exige <area>:read; os demais métodos, <area>:write. Registrar e renovar um domínio também exigem billing:write; vincular um domínio a um servidor também exige dns:write. Uma chamada sem o escopo responde 403 com required_scopes. As mesmas regras se aplicam ao servidor MCP quando ele é usado com uma chave.

Endpoints

URL base: https://nameocean.net/api/v1/

A referência da API traz todos os campos, códigos de erro e um exemplo curl por endpoint; o openapi.json pode ser importado no Postman ou no Insomnia.

Domínios

GET/domains/check?name=example.comDisponibilidade e preço
GET/whois/{name}Dados WHOIS/RDAP de qualquer domínio: registrador, datas, status, servidores de nomes
GET/domainsListar os seus domínios
POST/domainsRegistar um domínio, pago a partir do seu saldo {"name", "years"}
GET/domains/{name}Detalhes, nameservers, estado do SSL
PATCH/domains/{name}Renovação automática e bloqueio de transferência {"auto_renew", "locked"}
PUT/domains/{name}/nameservers{"nameservers": [...]} ou "nameocean"
POST/domains/{name}/renewRenovar por um ano (nos 60 dias anteriores à expiração)
GET/domains/{name}/auth-codeCódigo de transferência

DNS

GET/dnsListar zonas DNS
POST/dnsCriar uma zona para um domínio registado noutro local {"name"}
GET/dns/{zone}/recordsListar registos
POST/dns/{zone}/recordsAdicionar um registo: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT
PATCH/dns/{zone}/records/{type}/{id}Alterar um registo
DELETE/dns/{zone}/records/{type}/{id}Eliminar um registo
POST/dns/{zone}/plan · applyAltere a zona inteira a partir de um arquivo YAML ou JSON · DNS como código →

SSL

GET/ssl/{zone}Estado, data de expiração e link de download
POST/ssl/{zone}Emitir um certificado wildcard gratuito
PATCH/ssl/{zone}Renovação automática {"auto_renew"}

Servidores de aplicações

{server} é o ID do servidor ou o seu domínio padrão, como 3f9a1c2e.nameocean.org.

GET/serversOs seus servidores com SSH, git remote, portas e domínios
GET/servers/{server}Um servidor
GET/servers/{server}/portsPortas abertas
POST/servers/{server}/portsAbrir uma porta TCP ou UDP {"port", "protocol"}
DELETE/servers/{server}/ports/{id}Fechar uma porta
GET/servers/{server}/domainsDomínios associados e o seu estado
POST/servers/{server}/domainsAssociar um domínio ou subdomínio com HTTPS {"domain"}
DELETE/servers/{server}/domains/{id}Desassociar um domínio
POST/servers/{server}/deploysApós o git push: reinicie as aplicações e registe o deploy
GET/servers/{server}/logsLogs das aplicações · todos os endpoints do servidor →

Exemplo: novo domínio com HTTPS

bash
# 1. Consultar o preço
curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY"

# 2. Registar (debita do seu saldo)
curl -X POST https://nameocean.net/api/v1/domains -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{"name": "kahvebot.com", "years": 1}'

# 3. Apontar para o seu servidor
curl -X POST https://nameocean.net/api/v1/dns/kahvebot.com/records -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{"type": "A", "hostname": "@", "ip": "203.0.113.10", "ttl": "5m"}'

# 4. SSL wildcard gratuito
curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"

A referência completa para agentes de IA, com todos os campos e tipos de registo, está em nameocean.net/llms.txt. GET /api/v1/ também se descreve a si mesmo.