Actualización de la API Unificada: Gestión de idempotencia mejorada
En el núcleo de cualquier integración de API robusta se encuentra la idempotencia — un mecanismo que garantiza que reintentar una solicitud no produzca efectos secundarios no deseados.
Para proporcionar mayor visibilidad sobre cómo se gestionan tus solicitudes, hemos introducido una pequeña pero significativa mejora en nuestros encabezados de respuesta.
Esta actualización se aplica a todos los servicios impulsados por la API Unificada — actualmente SIGN IT, SIGN FR y E-INVOICE.
El desafío: “¿Fue esto una repetición?”
Sección titulada «El desafío: “¿Fue esto una repetición?”»Cuando se reintenta una solicitud utilizando el mismo X-Idempotency-Key, nuestra API devuelve correctamente la respuesta en caché de la operación original. Este comportamiento evita el procesamiento duplicado y es fundamental para integraciones confiables.
Sin embargo, esto puede dificultar la depuración. En ciertas situaciones — especialmente al investigar casos límite — puede no estar inmediatamente claro si una respuesta fue generada de nuevo o servida desde la caché de idempotencia.
La solución: X-Idempotency-Replayed
Sección titulada «La solución: X-Idempotency-Replayed»Con la última versión de la API Unificada del 18 de marzo de 2026, todas las respuestas POST y PATCH incluyen ahora un nuevo encabezado: X-Idempotency-Replayed.
Este encabezado indica explícitamente si una respuesta fue repetida desde la caché de idempotencia:
X-Idempotency-Replayed: "true"
La solicitud fue identificada como un reintento y la respuesta fue devuelta desde la caché.
X-Idempotency-Replayed: "false"
La solicitud fue procesada como una nueva operación y la respuesta fue generada normalmente.
Con esta actualización, el comportamiento de idempotencia se vuelve más transparente — reduciendo el tiempo de depuración y ayudándote a construir integraciones más confiables.
Was this page helpful?