Reintentos seguros

Cómo reintentar una llamada que transacciona sin crearla dos veces.

Versión de la API v1 · Ver como Markdown

Una red puede fallar después de que Ryde ya actuó. Sin protección, el reintento evidente crea un segundo viaje o un segundo pedido, y un agente de IA reintentando tras un tiempo de espera es exactamente el escenario para el que esto existe.

Idempotency-Key: 7f1c2b8e-49aa-4d2b-9d5f-6c3e0b1a8d24

• OBLIGATORIA en toda operación que crea una transacción. Opcional pero respetada en cancelaciones.
• Usa un UUID nuevo por acción prevista, no por reintento ni por cliente.
• Una repetición con la MISMA clave y el mismo cuerpo reproduce la respuesta original, incluido su estado. Ryde no actúa dos veces.
• La misma clave con un cuerpo DIFERENTE se rechaza con 409 IDEMPOTENCY_KEY_REUSED. Una clave identifica una transacción prevista.
• Las claves se conservan 24 horas; después, la misma clave se trata como nueva.

Genera la clave ANTES del primer intento y consérvala junto con la solicitud que reintentas. Una clave generada dentro del bucle de reintento es una clave nueva cada vez y no protege nada.