Empezar
Idempotencia
Manda una Idempotency-Key con cada petición. Un reintento por timeout con la misma clave no corre otra vez.
Última actualización
Cómo funciona
Idempotency-Key: 8d1c5b1e-3e0a-4d3c-9b8a-2f1e0c7a6b55La clave es cualquier cadena única por petición — un UUID basta. Se reserva antes del efecto, así que dos reintentos concurrentes no pueden correr los dos: el segundo contesta in_flight con un Retry-After.
Cuando el primer intento termina, un reintento con la misma clave contesta refused con motivo duplicate y cómo terminó el primer intento. El resultado original no se devuelve: solo se conserva que pasó.
Sin la cabecera, un reintento es una petición nueva. La protección dura 24 horas.
Las lecturas no llevan clave: leer no cambia nada, así que no hay nada que pueda correr dos veces.
En los clientes
Los SDK reciben la clave como segundo argumento y nunca inventan una en silencio; la CLI y el nodo de n8n generan una por llamada y la devuelven en la salida, para que puedas reintentar exactamente lo mismo si el proceso murió antes de leer la respuesta.