Clave de idempotencia

Una clave de idempotencia es un valor único que el llamante adjunta a una petición con efectos secundarios, para que el servidor reconozca el reintento de la misma operación y devuelva el resultado original en lugar de ejecutarla otra vez.

En las APIs de viaje, el uso canónico es la reserva. Un timeout tras una petición de reserva deja al llamante a ciegas: ¿tuvo éxito? Con una clave de idempotencia, el llamante reintenta con la misma clave y obtiene una respuesta definitiva, nunca una reserva duplicada.

Dos reglas hacen seguro el mecanismo. Una clave debe ser única por intención y nunca reutilizarse para otra reserva. Y el servidor debe rechazar la misma clave llegando con un cuerpo distinto; en traveldistro eso devuelve un 409 con el código IDEMPOTENCY_CONFLICT. Para el comportamiento completo de reintentos, vea la guía sobre idempotencia y la página de fiabilidad.