Domínios pela API: consultar um nome, registrar, renovar e transferir com o saldo

Domínios e DNS·· 56 visualizações· 4 min de leitura

A resposta curta: pela API lista os seus domínios, consulta se um nome está livre e quanto custa, registra, renova e transfere pagando com o saldo da conta, e muda nameservers, bloqueio e renovação automática. As compras precisam de domains:write, billing:purchase e do cabeçalho Idempotency-Key.

Listar e consultar

Operação O que faz Permissão
GET /v1/domains Os domínios da conta, primeiro os próximos a expirar, em páginas. Filtro ?status=active. domains:read
GET /v1/domains/{domain} Um domínio, pelo nome ou pelo id. domains:read
GET /v1/domains/availability Se um nome está livre e o preço de um ano (registro, renovação e transferência). domains:read

curl "https://api.mozout.com/v1/domains/availability?domain=yourcompany.com" -H "Authorization: Bearer $RLX_API_KEY"

Se a consulta disser unknown, não foi possível confirmar agora se o nome está livre, e o registro pela API não avança. Tente mais tarde.

Registrar, renovar e transferir

1 Confirme o nome e o preço com GET /v1/domains/availability.
2 Faça o pedido com POST /v1/domains/register (ou /v1/domains/{domain}/renew, ou /v1/domains/transfer com o código de transferência), sempre com Idempotency-Key.
3 O pagamento sai do saldo da conta, dentro do limite de gastos da chave. Se faltar saldo, o preço tiver mudado ou o perfil da conta estiver por completar, nada é cobrado.
4 A resposta é 202 com um action_id: acompanhe-o como explicamos em operações longas.

curl https://api.mozout.com/v1/domains/register -X POST \
-H "Authorization: Bearer $RLX_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6f1d2c3a-8b4e-4f7a-9c21-1d2e3f4a5b6c" \
-d '{"domain": "yourcompany.com", "years": 1}'

Um domínio não pode ficar com mais de 10 anos de validade. Algumas extensões, incluindo o .mz, são tratadas manualmente e demoram mais. Os preços estão na página de preços de domínios.

O que só se faz no My MozOut

Estes casos respondem 422 com um portal_url, que leva ao lugar certo no My MozOut:

Caso Porquê
Nomes .mz e .ao com até 3 caracteres Têm preço próprio.
.ac.mz, .gov.mz e .mil.mz Pedem documentos.
Extensões que pedem dados extra do titular Os dados preenchem-se no My MozOut.
Transferências de .mz e .ao Tratam-se no My MozOut.

Nameservers, bloqueio, renovação e contatos

Operação O que faz
GET e PUT /v1/domains/{domain}/nameservers Ler e mudar os nameservers. Indique de 2 a 5.
GET e PUT /v1/domains/{domain}/lock O bloqueio de transferência.
PUT /v1/domains/{domain}/auto-renew A renovação automática.
GET /v1/domains/{domain}/contacts Os contatos no registro do domínio.
POST /v1/domains/{domain}/transfer-code Pede o código de transferência. Precisa de domains:transfer_code e do nome em confirm. O código nunca vem na resposta: vai para o e-mail da conta ou do titular.
O domínio do e-mail da conta está protegido. Se o e-mail com que entra na conta, ou o de um usuário dela, for deste domínio, mudar os nameservers responde 409 account_email_domain, também em Sandbox: quem controla esse e-mail recebe a reposição da senha e o código de entrada. Faça essa alteração no My MozOut.
Os nameservers e o bloqueio podem vir de uma cópia com até 60 segundos, que não conta para o limite de 30 leituras por minuto; os contatos são sempre lidos na hora. O que altera pela API aparece logo. Mudar os contatos, o titular, a privacidade e o reencaminhamento ainda não está na API.

Quer registrar domínios a partir do seu sistema? Veja a página da API e teste primeiro com uma chave Sandbox, que não cobra nada.

Ver a página da API

VEJA TAMBÉM

DNS pela API: criar, alterar e apagar registros, e restaurar uma cópia da zona

Operações longas na API: a resposta 202, o action_id e acompanhar o resultado

Idempotency-Key na nossa API: repetir uma compra, um pagamento ou um pedido sem o fazer duas vezes

Permissões sensíveis da API e limite de gastos: pagar, comprar, reinstalar, entrar no cPanel

A API para revendedores e agências: conta, programas de revenda e o que a API não cobre

Limites de pedidos da API: por chave, por conta e por tarefa, os cabeçalhos e o que fazer num 429

PRODUTO RECOMENDADO

Registe o seu domínio .com

Garanta o nome da sua empresa antes que outro o registe. a partir de R$ 93,50/ano

Pesquisar domínio
Esta resposta foi útil? Sua resposta nos ajuda a melhorar este artigo.

Artigos Relacionados

Domínios e DNS 2.152 Como verificar o DNS do domínio Verificar o DNS de um domínio é descobrir para onde ele está apontando neste momento. É o primeiro passo sempre que um s...
Domínios e DNS 2.511 Como localizar o DNS da hospedagem Sempre que precisar de apontar um domínio para a sua hospedagem na MozOut, vão pedir-lhe os nameservers - também chamado...
Domínios e DNS 2.313 Como configurar o DNS de um domínio Configurar o DNS é dizer ao mundo para onde o seu domínio deve apontar. Há dois níveis, e vale a pena distingui-los ante...
Domínios e DNS 2.159 Como trocar o DNS de um domínio já configurado Trocar o DNS de um domínio que já funciona exige mais cuidado do que configurar um domínio novo. Aqui não parte do zero:...
Domínios e DNS 2.323 Quanto tempo demora a propagação do DNS Mudou os nameservers ou um registro DNS e ainda não aconteceu nada. É normal - as alterações de DNS não são imediatas. Q...
Domínios e DNS 87 DNS pela API: criar, alterar e apagar registros, e restaurar uma cópia da zona A resposta curta: a API lê e altera a zona DNS dos domínios activos da sua conta que tenham o DNS ligado (liga-se no My...