Limitaciones | CNPJws

Limitaciones de uso de la API Pública de CNPJ.ws: 3 solicitudes por minuto por IP y el error HTTP 429.

La API Pública tiene la limitación de atender solo 3 solicitudes por minuto desde una misma IP, entienda que esta limitación es independiente del hecho de que la consulta haya tenido éxito al encontrar el CNPJ. Después de superar este límite, el solicitante tendrá que esperar a que se completen los 60 segundos para poder hacer la próxima solicitud.

El usuario recibirá un mensaje de error y el código de estado HTTP 429:

{
  "status": 429,
  "titulo": "Muitas requisições",
  "detalhes": "Excedido o limite máximo de 3 consultas por minuto. Liberação ocorrerá em Thu Jun 03 2021 16:15:00 GMT-0300 (Horário Padrão de Brasília)"
}

Si la API detecta un volumen anormal de errores — más de 360 errores HTTP 429 en la misma hora, señal de que el solicitante sigue insistiendo incluso después de ser bloqueado — la IP será penalizada y no podrá hacer consultas durante 1 hora. Si el comportamiento persiste, el bloqueo se renovará por otra hora. Ejemplo:

{
  "status": 429,
  "titulo": "Muitas requisições",
  "detalhes": "Excedido o limite máximo de 360 erros HTTP 429 por hora. Liberação ocorrerá em Thu Jun 03 2021 16:15:00 GMT-0300 (Horário Padrão de Brasília)"
}