A resposta curta: pela API lista os seus domínios, consulta se um nome está livre e quanto custa, regista, 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 (registo, renovação e transferência). |
domains:read |
curl "https://api.interweb.co.mz/v1/domains/availability?domain=asuaempresa.co.mz" -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 registo pela API não avança. Tente mais tarde.
|
Registar, 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.interweb.co.mz/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": "asuaempresa.co.mz", "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 Meu Interweb
Estes casos respondem 422 com um portal_url, que leva ao sítio certo no Meu Interweb:
| 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 Meu Interweb. |
| Transferências de .mz e .ao |
Tratam-se no Meu Interweb. |
Nameservers, bloqueio, renovação e contactos
| 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 contactos no registo 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 utilizador dela, for deste domínio, mudar os nameservers responde 409 account_email_domain, também em Sandbox: quem controla esse correio recebe a reposição da senha e o código de entrada. Faça essa alteração no Meu Interweb.
|
|
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 contactos são sempre lidos na hora. O que altera pela API aparece logo. Mudar os contactos, o titular, a privacidade e o reencaminhamento ainda não está na API.
|
|
Quer registar 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 registos, 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 .co.mz Garanta o nome da sua empresa antes que outro o registe. a partir de 3.751,20 MT/ano Pesquisar domínio |
Português
English
