Para desenvolvedores
Limites e erros
Regras de uso, endereços bloqueados e como a API informa erros.
Estas regras valem para o site e para a API.
Limites
- 30 consultas por minuto por IP. Acima disso a resposta é 429, com o cabeçalho Retry-After.
- Até 20 portas por consulta no verificador de portas.
- No Fetch: até 5 redirecionamentos, 10 segundos e 64 KB de corpo.
- O ping para sozinho depois de 30 pacotes.
Endereços bloqueados
Por segurança, não consultamos endereços privados, locais ou reservados, como 192.168.x.x, 10.x.x.x e 127.0.0.1.
Erros
Quando algo dá errado, a resposta traz um campo error com a explicação, no idioma enviado no cabeçalho x-lang ou Accept-Language.
{ "error": "Esse domínio não parece válido." }Códigos de status
- 400: parâmetro inválido.
- 403: endereço privado ou reservado.
- 404: domínio não encontrado.
- 429: limite de consultas.
- 502 e 504: o destino não respondeu.