Las redes hacen que los resultados sean inciertos
Una solicitud puede llegar al servidor y confirmarse exitosamente incluso cuando el navegador nunca recibe la respuesta. Reintentar es razonable, pero sin una identidad de solicitud estable el servidor no puede distinguir un reintento de un nuevo comando.
Para la creación de enlaces públicos, esa ambigüedad puede producir alias duplicados, registros confusos o efectos secundarios repetidos.
Una clave representa una mutación prevista
El cliente envía una clave de idempotencia única con la solicitud de creación. El servidor almacena el resultado junto con una huella digital de la entrada. Repetir la misma clave y entrada devuelve el resultado original.
El uso de la misma clave con diferentes entradas se rechaza como conflicto. Esto protege tanto al cliente como al servidor de cambiar accidentalmente el significado de un comando anterior.
La durabilidad importa en la producción
Un almacén de idempotencia en memoria es suficiente para pruebas aisladas, no para un servicio de producción de instancias múltiples. La clave de producción y el resultado deben residir en el mismo límite de dominio duradero que la mutación, con vencimiento y alcance de inquilino.
El mismo patrón se aplica a pagos, procesamiento de webhooks, importaciones y trabajos donde un efecto duplicado sería costoso.