Idempotencia
Repite escrituras sin ejecutarlas dos veces.
Todas las operaciones de escritura requieren un Idempotency-Key de 1 a 200 caracteres. Genera un UUID por cada cambio que quieras realizar. Si ocurre un error de red, conserva el mismo UUID y contenido.
Una solicitud idéntica devuelve el resultado guardado con Idempotent-Replayed: true. Reutilizar la clave con otro contenido u otra operación devuelve 422 idempotency_key_reused. Si falta la cabecera, devuelve 400 idempotency_key_required.
El ámbito de la clave es el tenant y el usuario. Por tanto, dos claves API del mismo usuario comparten el ámbito de idempotencia. Conserva la clave y la solicitud durante al menos 24 horas.
Las operaciones de lectura no necesitan Idempotency-Key. Esto también se aplica a búsquedas POST, validaciones y descargas masivas cuando la referencia indica que la operación es de lectura.