Por que eu uso Idempotency-Key em qualquer API pública
Sempre que uma integração acontece pela internet, existe uma possibilidade de timeout. Quando isso acontece, o cliente normalmente faz retry. Sem idempotência, isso pode criar dois pedidos, dois pagamentos ou duas mensagens. Por isso toda API pública que desenvolvo aceita uma Idempotency-Key . Se a mesma operação chegar novamente, a resposta é a mesma da primeira execução. Isso torna a integração previsível e evita efeitos colaterais. Pode parecer um detalhe, mas é justamente esse tipo de detalhe que separa uma API de demonstração de uma API pronta para produção.