Idempotência
dev
Propriedade de uma operação que pode ser repetida várias vezes produzindo sempre o mesmo resultado, sem efeitos colaterais adicionais.
Uma operação é idempotente quando executá-la uma ou várias vezes leva ao mesmo estado final. Apertar o botão do elevador cinco vezes não chama cinco elevadores — isso é idempotência.
Por que isso é crucial em sistemas distribuídos: a rede falha, requisições são reenviadas, webhooks chegam duplicados. Se “criar cobrança” não for idempotente, o cliente é cobrado duas vezes.
Na prática: no REST, GET, PUT e DELETE são idempotentes por definição; POST não. Para proteger operações sensíveis, usa-se uma chave de idempotência — um identificador único que o servidor usa para reconhecer e ignorar repetições.