Limite de requisições
Para garantir estabilidade e desempenho, aplicamos limites de requisições por recurso. Cada endpoint pode possuir um número máximo de chamadas por minuto; ao ultrapassar esse limite a API retornará um erro de rate limiting (normalmente 429 — Too Many Requests). Para mitigar, implemente retries com backoff exponencial, redução da frequência de chamadas e cache quando possível.
⚠️ Erro retornado:
O response retornado quando o limite de requisição é atingido é:1{2 "status": false,3 "data": {4 "code": 429,5 "errorCode": "THROTTLE_LIMIT_REACHED",6 "message": "Try again in 21 seconds."7 }8}👀 Cabeçalhos de respostas retornados:
Para os cabeçalhos de resposta, também são retornados os seguintes headers:1X-RateLimit-Limit: 302X-RateLimit-Reset: 21Sendo o "X-RateLimit-Limit" a quantidade maxima de tentativas por minuto para o recurso solitado e "X-RateLimit-Reset" sendo a quantidade de tempo (em segundos) restante para a proxima tentativa.