Pular para o conteúdo principal

Considerações e limitações

Ao integrar com nossos webhooks, é importante estar ciente de certas considerações e limitações para garantir uma implementação suave e eficiente. Esta página descreve os principais pontos que você precisa saber.

Limites de registro de endpoint​

  • Máximo de Endpoints: Você pode registrar até 2 endpoints de webhook por conta.
  • Endpoints Adicionais: Se você precisar de mais de 2 endpoints, entre em contato com nossa equipe de vendas para discutir suas necessidades.

Ordenação e Concorrência de Eventos​

  • É importante observar que os eventos de webhook não são garantidos de serem processados em ordem.
  • Devido à natureza concorrente da entrega de webhook, os eventos podem chegar fora de sequência.

Isso pode levar a inconsistências e possíveis condições de corrida. Os usuários devem estar cientes dessas limitações e projetar seus sistemas para lidar com possível processamento de eventos fora de ordem, aplicando as devidas validações com a propriedade eventDate.

Entrega de Eventos​

  • Agrupamento de Eventos: Nossa plataforma pode enviar até 100 eventos por requisição. Esse mecanismo de agrupamento ajuda a minimizar o número de requisições enviadas para o seu servidor e evita enviar spam para a sua API com muitas requisições individuais.
  • Tempo: Se não houver eventos recebidos em um intervalo de 5 segundos, enviaremos a requisição com os eventos acumulados até o momento.

Mecanismo de Retentativa​

  • Sem Retentativas: Nossa plataforma não fornece operações de retentativa para entregas de webhook com falha no momento.
  • Garantir Throughput: Certifique-se de que sua API possa lidar com o throughput de requisições e seja capaz de processar os eventos de forma eficiente.
  • Status de Resposta: Certifique-se de que seu endpoint de webhook retorne um código de status HTTP 202 Accepted para reconhecer o recebimento bem-sucedido da requisição.

Lidar com Alto Throughput​

Para lidar com o potencial alto throughput de eventos:

  • Escalabilidade: Garanta que sua infraestrutura de servidor possa escalar para lidar com picos de requisições de webhook recebidas.
  • Processamento Assíncrono: Implemente o processamento assíncrono para reconhecer rapidamente o recebimento do webhook e processar os eventos em segundo plano, pois nossa plataforma aguarda apenas 5 segundos antes de encerrar a requisição.