Rate Limit

Para garantir maior estabilidade e performance das nossas APIs, informamos que a partir de 14 de setembro de 2025 os principais métodos de consulta de proposta passarão a ter um limite de requisições por minuto (rpm) por usuário de integração.

Os endpoints afetados são:

Endpoint	Novo limite
GET /v1/propostas/{proposta}	200 RPM
GET /v1/propostas/{proposta}/resumo	200 RPM
GET /v1/propostas/{proposta}/situacao	200 RPM
GET /Consignado/Proposta/ObterDetalhamento	200 RPM
GET /v1/propostas/movimentacao	100 RPM
GET /Consignado/Proposta/ListarPorDataMovimentacao	100 RPM
GET /Consignado/Comissao/ObterDetalhamentoContrato	200 RPM
GET /comissoes/contratos/{contrato}	200 RPM
GET /v1/liberacoes/propostas	100 RPM

 

Orientações para criadores de sistemas e correspondentes

• Importações em lote: ajuste seus processos para consultar lotes de, no máximo, 200 propostas por minuto. Caso precise sincronizar volumes maiores, distribua as chamadas gradualmente (ex.: 3–4 requisições por segundo) ou implemente filas assíncronas.
  

• Tratamento de erros: se o limite for ultrapassado, a API retornará o status HTTP 429 – Too Many Requests. Insista apenas após aguardar pelo menos 60 segundos. Extrapolações contínuas podem acarretar bloqueio temporário do usuário de integração.
  

• Ambiente de homologação: recomendamos testar as adaptações com antecedência no ambiente de HML, que já possui as mesmas restrições.
  

Webhook em tempo real

Para facilitar a adaptação ao novo limite e oferecer um fluxo mais ágil, estamos liberando gradualmente nosso novo Webhook de Propostas, que envia em tempo real qualquer mudança de situação da proposta diretamente para o seu sistema.

Se quiser testar antes do lançamento geral, basta solicitar no nosso e‑mail pedindo habilitação; nas próximas semanas liberaremos o Webhook para todos os corbans integrados e também atualizaremos a nossa documentação.

Caso tenha dúvidas ou necessite de apoio para adequar seu sistema, estamos à disposição pelo e‑mail api@bempromotora.com.br.