O que significa um endpoint ser idempotente, e como você tornaria um endpoint de criação idempotente?

Um endpoint idempotente produz o mesmo resultado sendo chamado uma vez ou cinco vezes com a mesma entrada. GET, PUT e DELETE são naturalmente idempotentes; POST não é. Você torna um endpoint de criação idempotente fazendo o cliente enviar uma chave de idempotência única, guardando essa chave junto com o recurso criado na mesma transação, e devolvendo o resultado original em qualquer repetição.

Idempotente significa que chamar duas vezes deixa o sistema no mesmo estado que chamar uma vez. PUT é idempotente porque você está declarando o estado final; POST normalmente não é, porque cada chamada significa faça mais um. Para um endpoint de criação eu faço o cliente gerar uma chave, tipicamente um UUID, e mandar como header. No servidor eu guardo essa chave numa tabela com restrição única, e escrevo na mesma transação do recurso em si, porque se esses dois commits puderem divergir o esquema inteiro é decorativo. Se a mesma chave voltar, eu busco e devolvo a resposta original com o status original. A parte que as pessoas esquecem é o caso concorrente, em que dois retries caem no mesmo milissegundo. O índice único trata disso: o segundo insert falha, eu capturo a violação e leio de volta o vencedor em vez de dar erro. Construí isso para um endpoint de pagamentos depois que a gente cobrou alguém em dobro durante uma instabilidade de rede.