A resposta curta: com uma chave válida pode fazer 90 pedidos por minuto, por chave, e 300 por minuto em toda a conta, somando as chaves. Algumas tarefas têm limites próprios, mais baixos. Quando passa o limite, a API responde 429 com o cabeçalho Retry-After: espere esse tempo e repita.
Os limites gerais e por tarefa
| Quem pede, ou o quê |
Limite |
| Com chave válida |
90 pedidos por minuto, por chave |
| Toda a conta, somando as chaves |
300 pedidos por minuto |
| Sem chave válida |
30 pedidos por minuto, por IP |
| Consultar nomes de domínio |
30 por minuto, por conta |
| Alterar domínios, DNS, ciclo de renovação e SMS, e fechar pedidos de suporte (limite comum) |
20 por minuto, por conta |
| Comprar domínios e produtos extra e pagar facturas (limite comum) |
5 por minuto, por conta |
| Ler nameservers, bloqueio, contactos e zona DNS |
30 por minuto, por conta (as respostas da cópia de 60 segundos não contam) |
| Pedir o código de transferência |
3 por hora, por conta |
| Abrir pedidos de suporte |
10 por hora, por conta |
| Responder a pedidos de suporte |
30 por hora, por conta |
| Descarregar o PDF de uma factura |
20 por minuto, por conta |
| Pesquisar na Base de Conhecimento |
30 por minuto, por conta |
| Pedir um cancelamento |
5 por hora, por conta |
GET /v1/ping e GET /v1/openapi.json contam sempre por IP, mesmo com chave. O corpo de um pedido pode ter até 1 MB.
Limites da hospedagem, do e-mail e dos servidores
| Área |
Limite |
| Hospedagem: alterações |
20 por minuto, por hospedagem |
| Hospedagem: ligação de entrada no cPanel |
5 por minuto |
| E-mail: alterações |
20 por minuto, por hospedagem |
| E-mail: senhas |
10 por minuto |
| Servidores: entre acções no mesmo servidor |
15 segundos |
| Servidores: acções em toda a conta |
10 por minuto |
| Servidores: senhas novas |
5 por hora, em toda a conta |
| Servidores: reinstalações ou restauros |
3 por hora, em toda a conta |
Na hospedagem e nos servidores, as chaves sandbox_ têm estes limites à parte: testar em Sandbox não gasta os de Produção.
|
Estes são os valores actuais e podem mudar. Não os escreva fixos no programa: leia os cabeçalhos de cada resposta, que dizem sempre o que vale nesse momento.
|
Os cabeçalhos que contam por si
| Cabeçalho |
O que diz |
| X-RateLimit-Limit |
Pedidos permitidos por minuto. |
| X-RateLimit-Remaining |
Pedidos que restam neste minuto. |
| X-RateLimit-Reset |
Quando acaba o minuto, em segundos Unix. |
| Retry-After |
Só no 429: quantos segundos deve esperar. |
GET /v1/limits devolve os mesmos valores, mais o limite de gastos da chave. Qualquer chave válida a pode chamar.
O que fazer quando recebe um 429
| 1 |
Espere pelo menos o tempo de Retry-After antes de repetir.
|
|
| 2 |
Se o 429 se repetir, aumente a espera a cada tentativa.
|
|
| 3 |
Evite ciclos de consulta muito rápidos. Para uma operação longa, consulte o estado com calma, em vez de perguntar sem parar: veja operações longas.
|
|
| 4 |
Nas listas, use per_page=100: cada página conta como um pedido, e menos páginas são menos pedidos. Veja a paginação.
|
|
|
Vários programas a bater no limite da conta? O de 300 por minuto soma todas as chaves. Se um script de relatórios gasta muito, espace-o: os outros programas agradecem.
|
|
Quer ver os limites ao vivo? A documentação, a partir da página da API, mostra-os em cada resposta do Playground.
Ver a página da API
|
PRODUTO RECOMENDADO Hospedagem de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 321,75 MT/mês (plano de 3 anos, com cupão) Ver planos |
Português
English
