As redes tornam os resultados incertos
Uma solicitação pode chegar ao servidor e ser confirmada com sucesso mesmo quando o navegador nunca recebe a resposta. Tentar novamente é razoável, mas sem uma identidade de solicitação estável, o servidor não consegue distinguir uma nova tentativa de um novo comando.
Para a criação de links públicos, essa ambiguidade pode produzir aliases duplicados, registros confusos ou efeitos colaterais repetidos.
Uma chave representa uma mutação pretendida
O cliente envia uma chave de idempotência exclusiva com a solicitação de criação. O servidor armazena o resultado junto com uma impressão digital da entrada. Repetir a mesma chave e entrada retorna o resultado original.
Usar a mesma chave com entrada diferente é rejeitado como conflito. Isso protege o cliente e o servidor de alterar acidentalmente o significado de um comando anterior.
A durabilidade é importante na produção
Um armazenamento de idempotência na memória é suficiente para testes isolados, não para um serviço de produção de múltiplas instâncias. A chave de produção e o resultado devem residir no mesmo limite de domínio durável que a mutação, com expiração e escopo de locatário.
O mesmo padrão se aplica a pagamentos, processamento de webhook, importações e trabalhos onde um efeito duplicado seria caro.