Empezá
Idempotencia
Cómo reintentar una escritura sin duplicar un pedido, un recibo o un pago.
Toda operación que escribe pide el encabezado Idempotency-Key: una clave que generás vos, única por intento, de hasta 255 caracteres. Un UUID nuevo por operación es lo más simple.
-H "Idempotency-Key: 0f8c1a2e-9b4d-4c7e-8a1f-3d2b6e5c4a90"Qué garantiza
Sección titulada «Qué garantiza»Si la red se corta y no sabés si la llamada llegó, repetila con la misma clave y los mismos datos. El ERP no repite la operación: devuelve el resultado de la primera vez, con el encabezado Idempotent-Replayed: true.
| Reintento | Resultado |
|---|---|
| Misma clave, mismos datos | El resultado original, sin volver a operar. |
| Misma clave, otros datos u otra operación | 422 idempotency.key-reused. |
| Sin clave | 400 idempotency.key-required. |
Las lecturas no la necesitan: repetir una lectura nunca cambia nada.
La versión del registro
Sección titulada «La versión del registro»Las operaciones que modifican un registro existente piden también la version que leíste. Si otra persona lo cambió en el medio, la llamada responde 409 record.stale en lugar de pisar su cambio. Volvé a leer el registro y decidí con los datos nuevos.