Throttling

Para ter acesso ao ambiente de produção é necessário realizar o tratamento do Throttling na sua aplicação.

O que significa?

O Mercos aceita requisições por tempo determinado. Isso se refere a um tempo de espera para o envio e processamento de requisição, evitando sobrecarga e eventual queda do servidor.

Na prática

O mecanismo de throttling ocorre quando você tenta enviar uma requisição e recebe um status_code 429, com o seguinte retorno no body:

{
   "tempo_ate_permitir_novamente": 5,
   "limite_de_requisicoes": 1
}

Ao receber um erro 429, sua aplicação deve:

  • Ler o campo tempo_ate_permitir_novamente no body da resposta.
  • Aguardar esse tempo (em segundos).
  • Reenviar a requisição após o tempo informado.

O tempo de espera indicado no erro 429 pode variar conforme a carga no sistema.

⚠️

Importante

Esse controle deve ser aplicado a todas as rotas, pois o limite é global.

O campo limite_de_requisicoes, presente no corpo da resposta com erro 429, indica a quantidade máxima de requisições que você pode enviar dentro do intervalo de tempo definido. Use essa informação para controlar o ritmo de requisições da sua aplicação, evitando ultrapassar o limite e ser bloqueado.