Saltar al contenido principal

Idempotencia

Iara Data utiliza claves de idempotencia para prevenir operaciones duplicadas. Esto es fundamental para la integridad de los datos — si una solicitud se envía dos veces (por ejemplo, debido a un reintento de red), solo la primera se ejecuta.

Cómo Funciona​

Incluye un encabezado Idempotency-Key en todas las solicitudes que mutan datos (POST, PUT, PATCH, DELETE):

curl -X POST https://lake.iaradata.com/api/v1/ingest/metrics \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Idempotency-Key: unique-uuid-12345" \
  -H "Content-Type: application/json" \
  -d '{"table": "sales", "rows": [...]}'

Comportamiento​

EscenarioQué Sucede
Primera solicitud con clave abc123La solicitud se ejecuta normalmente, el resultado se almacena en caché
Segunda solicitud con la misma clave abc123Retorna el resultado almacenado en caché sin volver a ejecutar
Clave diferente xyz789Nueva solicitud se ejecuta normalmente

Explorador de Idempotencia​

Los administradores pueden explorar las respuestas idempotentes almacenadas en caché en Configuración → Explorador de Idempotencia.

Captura de pantalla del Explorador de Idempotencia mostrando la barra de filtros y la lista de respuestas en caché

Filtros​

FiltroDescripción
ClaveBuscar por clave de idempotencia
MétodoGET, POST, PUT, PATCH, DELETE
RutaPrefijo de ruta de URL
Código de EstadoCódigo de estado HTTP de la respuesta
DesdeMostrar solo entradas posteriores a una fecha

Vista de Detalle​

Haz clic en cualquier entrada para ver:

  • Clave — La clave de idempotencia
  • Método y Ruta — El endpoint de la solicitud
  • Hash del Cuerpo — Hash del cuerpo de la solicitud
  • Estado — Código de estado de la respuesta
  • Respuesta Completa — El cuerpo de la respuesta almacenada en caché
  • Marca de Tiempo — Cuándo se almacenó en caché

Reproducir​

Los administradores pueden hacer clic en Reproducir para volver a ejecutar una solicitud almacenada en caché. Esto es útil para depuración o para reintentar después de una corrección.

info

Buena práctica: Usa UUIDs o claves determinísticas para la idempotencia. Por ejemplo, ingest-{fileHash}-{timestamp} asegura que el mismo archivo no se ingeste dos veces.