igergov.com
← Artículos
APIHTTPDevOps · 3 min · BG EN ES DE

Reintentos de peticiones POST: cómo evitar duplicados

¿Es seguro reintentar un POST tras agotar el tiempo de espera? Resultado desconocido, idempotencia y límites de las claves en Stripe API v1.

Una aplicación hipotética de notas envía una petición POST para crear una nota. Se agota el tiempo de espera sin recibir respuesta. ¿Debe enviarla otra vez? Para decidirlo, primero hay que separar dos preguntas: si se recibió una respuesta y si se creó la nota.

Falta la respuesta, se desconoce el resultado

Consideremos una secuencia posible. El cliente envía la petición. El servidor la procesa y confirma la escritura en la base de datos. La respuesta se pierde en el camino de vuelta. El cliente detecta que se agotó el tiempo de espera. En este ejemplo, la nota ya existe. Si cada POST recibido crea una nota, repetirlo creará otra.

AWS advierte expresamente de que agotar el tiempo de espera no demuestra que no haya habido efectos secundarios. Por tanto, «no recibí respuesta» no significa «la operación no se ejecutó». Esa es la diferencia entre un resultado desconocido y un fallo confirmado. (builder.aws.com)

Qué significa idempotencia

Según RFC 9110, apartado 9.2.2, la idempotencia exige el mismo efecto previsto en el servidor al enviar una petición una o varias veces, no respuestas idénticas. Desaconseja reintentar automáticamente peticiones no idempotentes sin conocer su semántica idempotente o comprobar que la primera no se aplicó. (rfc-editor.org)

En Amazon Builders’ Library, Malcolm Featonby describe un identificador proporcionado por el cliente para reconocer reintentos. Los mismos parámetros no expresan por sí solos la intención: quizá se quieran dos objetos idénticos. La clave funciona gracias al comportamiento acordado del servidor, no simplemente por aparecer en la petición. (aws.amazon.com)

El contrato concreto de Stripe API v1

Stripe API v1 devuelve el estado y cuerpo guardados, incluidos errores 500. Solo guarda resultados tras iniciar la ejecución: no ante validaciones fallidas o conflictos con peticiones concurrentes. Cambiar parámetros manteniendo la clave produce un error. API v2 tiene otra semántica de repetición. (docs.stripe.com)

Envíe Idempotency-Key desde el primer intento. Stripe indica reintentar con la misma clave y parámetros durante las primeras 24 horas. Después puede eliminar la clave; reutilizarla entonces puede iniciar otra petición. Si sigue sin conocerse el resultado, detenga los reintentos y esclarezca lo ocurrido. (docs.stripe.com)

Cuándo reintentar es otra pregunta

AWS recomienda limitar los reintentos y aumentar las pausas hasta un máximo para controlar la carga. La conclusión de ingeniería es distinta: esperar más no establece si repetir la operación es correcto. (builder.aws.com)

En su explicación sobre jitter, Marc Brooker muestra por qué unas pausas iguales pueden mantener las peticiones agrupadas en el tiempo. Un componente aleatorio las distribuye. Esto cambia cuándo se envían, no cómo reconoce el servidor una operación. (aws.amazon.com)

Qué aclarar antes de automatizar los reintentos

Como ejercicio sobre el papel, retome el ejemplo de la nota. Sitúe una interrupción antes del procesamiento, después de la escritura y antes de recibir la respuesta. Para cada caso, anote qué sabe el cliente, qué sigue siendo desconocido y qué parte del contrato de la API justifica la siguiente acción. No sustituya lo desconocido por una suposición.

Después, añada dos preguntas a la revisión de la integración: «¿Cómo determinaremos el resultado cuando cesen los reintentos?» y «¿Qué garantía ofrece exactamente este endpoint, en esta versión, para esta operación?»

Fuentes