Idempotência É Fácil Até a Segunda Requisição Ser Diferente

A idempotência não se resolve apenas com o armazenamento de uma chave de idempotência. Os casos complexos surgem quando as retries chegam concorrentemente, após falhas parciais, depois de side effects em sistemas downstream, ou com a mesma chave, mas com conteúdo de requisição diferente. Um design robusto deve considerar a operação com escopo definido, o comando canônico, o estado de execução, o contrato de replay, a política de expiração e o caminho de recuperação, para que o servidor possa reexecutar (replay), rejeitar ou conciliar, em vez de duplicar acidentalmente os side effects.