Escritas Idempotentes em Integrações
Torne retries seguros desenhando a operação para que o mesmo evento possa ser processado mais de uma vez sem duplicar efeitos colaterais.
O nível de evidência descreve minha experiência com o conteúdo. Fonte oficial descreve contrato/documentação da plataforma. Observação de produção não deve ser tratada automaticamente como limite oficial.
Timeouts de rede e retries de 429/5xx podem deixar o caller sem saber se a escrita anterior realmente foi concluída.
Use chaves externas/de evento estáveis, semântica de upsert quando aplicável, persista estado de processamento e defina o comportamento de retry antes de automatizá-lo.
Exige chave estável ou contrato de deduplicação
Gestão de estado adiciona trabalho de implementação
Nem toda operação downstream é naturalmente idempotente