Idempotencia y correlacion

Idempotency-Key

Toda mutacion externa debe enviar una clave opaca y estable para el intento logico:

Idempotency-Key: 0190b66a-83e0-7dcb-9e72-f04b16ef101a

• La misma clave y el mismo payload devuelven el resultado original.
• La misma clave con un payload diferente produce un conflicto.
• No reutilice claves entre operaciones o tenants.
• No utilice el identificador de correlacion como clave de idempotencia.

X-Correlation-Id

Puede enviar un UUID para correlacionar logs y eventos:

X-Correlation-Id: e922d8e6-e275-43d2-9300-68157d828dce

El API devolvera el valor aceptado o uno generado por el servidor. Incluyalo al solicitar soporte, pero nunca adjunte PII o credenciales.