Skip to main content

Limites de Uso

Todos os endpoints da API possuem limites de requisições por token. Os limites variam de acordo com o tipo de token utilizado.

Limites por tipo de token

Tipo de tokenLimiteReset
Gratuito5 requisições por minuto1 minuto
PagoLimites superiores (conforme plano)Conforme plano

Comportamento ao atingir o limite

Quando o limite de requisições é atingido, a API retorna o status HTTP 429 Too Many Requests:
{
  "error": "Limite de requisições excedido."
}
Aguarde o período de reset antes de fazer novas requisições.

Limites por endpoint

Todos os endpoints possuem o mesmo limite de 5 consultas por minuto para tokens gratuitos:
EndpointLimite (gratuito)
GET /v1/cnpj/{cnpj}5 req/min
GET /v1/logos/{cnpj}5 req/min
GET /v1/simples/{cnpj}5 req/min
GET /v1/cidades/{id}5 req/min

Tokens pagos

Tokens pagos oferecem limites superiores e são indicados para aplicações em produção. Para mais informações sobre planos pagos, entre em contato pelo email suporte@poupey.com.br.