Chave de idempotência: o que é
Uma definição direta, sem enrolação, do conceito que evita que uma requisição repetida publique o mesmo post duas vezes.
Por André LugIdempotência é a propriedade de uma operação que produz o mesmo resultado independentemente de quantas vezes ela é executada com os mesmos parâmetros. Uma chave de idempotência (idempotency key) é o identificador que você envia junto com uma requisição para garantir essa propriedade: se a mesma chave for enviada de novo, a API retorna o resultado da primeira execução em vez de repetir a ação.
Por que isso importa numa API de publicação
Na maioria das APIs, uma requisição repetida por engano é um incômodo pequeno — uma linha a mais no banco. Numa API que publica em redes sociais de verdade, o mesmo erro pode significar o mesmo anúncio de lançamento saindo duas vezes no Instagram e no LinkedIn de um cliente, porque o seu código tentou de novo depois de um timeout sem saber se a primeira chamada já tinha sido aceita.
Enviar uma chave de idempotência estável em toda chamada de criação de post resolve exatamente esse problema: repetir a chamada com a mesma chave devolve a resposta original, sem publicar de novo.
Como gerar uma boa chave
Uma boa chave é estável para uma publicação lógica e diferente para cada publicação distinta — normalmente derivada do seu próprio ID de job interno, de fila, ou de comando, não de um UUID aleatório gerado a cada tentativa (isso anularia o propósito: cada nova tentativa pareceria uma requisição nova).
