Idempotência

Definição

Idempotência descreve uma operação cuja repetição produz o mesmo efeito pretendido que uma única execução. O objetivo é comparar o estado final esperado, não a resposta recebida. Uma chamada repetida mantém o sistema no mesmo estado que a primeira criaria, e é essa estabilidade que permite reenviar com segurança.

O efeito depois de uma ou várias tentativas

Quando uma resposta se perde, você não sabe se a operação foi concluída. A idempotência permite reenviar a operação sem criar um segundo efeito, porque o serviço reconhece a tentativa anterior. O reenvio repete a mesma chamada, e o destino responde com o resultado já registrado em vez de executar o efeito de novo.

Efeito, não resposta

A idempotência diz respeito ao efeito pretendido, e as respostas não precisam ser byte a byte idênticas. Uma leitura repetida também não altera o estado por contrato, e o comportamento real do servidor determina a aplicação prática. A conferência deve olhar o estado do recurso, e não comparar o texto das respostas.

Repetição de efeito e verificação

A falha comum é reenviar a operação com uma chave nova: o serviço não reconhece a tentativa anterior e cria um segundo efeito. Para verificar, repita a chamada com a mesma chave e confira o estado do recurso no destino. Quando a repetição gera um registro novo, a associação entre as tentativas se perdeu, e a contagem de efeitos no destino mostra se a operação se comportou como idempotente.

Aplicação na formação

n8n Experts

Na formação n8n Experts, idempotência protege o efeito das operações em fluxos com retry e chamadas repetidas.

Conhecer a formação →