Pode explicar o que significa o termo idempotência no contexto da programação e API?

A idempotência na programação e API significa que a execução repetida da mesma operação com os mesmos parâmetros não alterará o estado do sistema após a primeira chamada.

Simplificando, se você chamar um método idempotente várias vezes seguidas, o resultado será o mesmo que se você o tivesse chamado uma única vez.

Por exemplo, o método HTTP PUT geralmente é idempotente: se você enviar uma solicitação para atualizar um recurso com os mesmos dados várias vezes, o estado do recurso não mudará após a primeira atualização.

Isso é importante para a confiabilidade dos sistemas, para evitar efeitos colaterais indesejados em solicitações repetidas, por exemplo, devido a falhas de rede ou reenvio de dados.