alerts.beta
Background - API1Created with Sketch.

Rate Limit

O que é Rate Limit?

Rate limit é o número de chamadas à API que o usuário ou aplicação pode realizar dentro de um período de tempo. Isso é feito para evitar a sobrecarga dos nossos sistemas e manter sua estabilidade e segurança.

Por padrão, permitimos 100 chamadas por minuto considerando leitura e escrita. Usuários que enviam muitas requisições em sequência e ultrapassam esse limite, receberão uma mensagem de erro com status code 429 .

HTTP Headers

Para conhecimento, enviamos no Header do response campos adicionais informando quais são os limites permitidos, quantas solicitações estão disponíveis e quanto tempo levará até que a cota seja restaurada, por exemplo:

  • RateLimit-Limit: Indica quantas chamadas a sua aplicação pode fazer à nossa API por janela de tempo. Como dito anteriormente, nossa janela de tempo é de 1 minuto.
  • RateLimit-Remaining: Indica o total de requisições do cliente disponíveis na janela de tempo.
  • RateLimit-Reset: Indica o tempo restante para que o limite de requisições seja redefinido.

Também enviaremos, no Header, informações sobre os limites por período e o número de solicitações restantes:

  • X-RateLimit-Limit-Minute: Indica quantas chamadas a sua aplicação pode fazer à nossa API por minuto.
  • X-RateLimit-Remaining-Minute: Indica o total de requisições do cliente disponíveis no minuto corrente.

isPageUseful.question