Limite de consumo das APIs(rate limit)

As APIs do BTG Pactual Empresas impõe um limite de requisição, por minuto, para as suas APIs.

Estas informações, afim de permitir que o sistema integrador consiga identificar se está se aproximando ou não do limite, são disponibilizadas via headers na resposta de todas as APIs

Header	Descrição
X-RateLimit-Limit	Limite de requisição por minuto dentro da janela
X-RateLimit-Remaining	Requisições restantes na janela de requisições
X-RateLimit-Reset	Timestamp Unix de reset da janela de requisições

O consumo é calculado por clientId realizando a requisição. Em outras palavras, caso seu sistema consuma um volume muito alto e possua apenas 1 clientId é primordial que haja a implementação de um fluxo de verificação destes valores.

O consumo ocorre independente da response da API retornar sucesso ou erro.

No momento em que o limite for atingido, a nosso sistema retornará o código 429 com o seguinte payload:

{
  "limit":120, //Cota de chamadas por minutos
  "reset_in_seconds":4, //Tempo em segundos para o reset da cota
  "identifier":"1a4b0f90-9e5a-4b51-a097-c88660c19ad4",
  "message":"Too many requests. Please try again later."
}