​

Rate Limits

​

Limites atuais

​

Headers de resposta

​

Exemplo de resposta com headers

HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 27

{ ... }

​

Resposta quando o limite é excedido

{
  "error": "RATE_LIMIT_EXCEEDED",
  "message": "Você atingiu o limite de requisições. Por favor, aguarde 27 segundos antes de tentar novamente.",
  "retry_after_seconds": 27,
  "retry_after_message": "27 segundos"
}

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 27
Retry-After: 27

​

Boas práticas

1. Implemente retry com backoff exponencial: ao receber 429, aguarde o tempo indicado no header Retry-After
2. Interprete X-RateLimit-Reset como segundos restantes: o valor atual não é timestamp Unix
3. Cache respostas: dados que mudam pouco (produtos, recompensas) podem ser cacheados localmente
4. Agrupe operações: em vez de consultar clientes um a um, use a listagem paginada
5. Preserve idempotência em retries: nos 3 writes críticos, reutilize a mesma X-Idempotency-Key