Recomendações
Atualizado
Atualizado
Antes de processar qualquer evento, é essencial avaliar o tipo de evento recebido. Verifique o campo que indica o tipo de evento para garantir que seu sistema está preparado para lidar com aquele evento específico. Isso ajuda a evitar erros de processamento e garante que apenas eventos relevantes sejam manipulados. Para eventos não reconhecidos, registre um log e considere descartá-los ou tratá-los conforme necessário.
É importante avaliar a versão do evento antes de processá-lo. Diferentes versões podem conter alterações significativas na estrutura dos dados. Assegure-se de que seu sistema é compatível com a versão do evento recebida.
O tempo de resposta do seu servidor ao receber um webhook deve ser rápido para evitar timeouts. Idealmente, a resposta deve ser enviada em menos de 10 segundos. É recomendado enviar uma resposta HTTP 200 OK imediatamente após receber o evento, antes de iniciar qualquer processamento complexo. Isso ajuda a garantir que a entrega do webhook seja considerada bem-sucedida pelo remetente.
⚠️ Aviso: Se o servidor não retornar uma resposta dentro desse período, o envio será considerado uma falha e o evento será reenviado. O sistema pode realizar múltiplas tentativas de reenvio até que uma resposta bem-sucedida seja recebida.
Eventos de webhook podem ser enviados mais de uma vez, como por exemplo um falso negativo de recebimento do evento por timeout. É recomendado que seu sistema seja capaz de lidar com duplicações para evitar processamento repetido ou inconsistências nos dados. Utilize um mecanismo de idempotência para garantir que cada evento seja processado apenas uma vez.
