Guía

Idempotencia

Si su sistema reintenta requests por timeouts de red, evite duplicar jobs con un Idempotency-Key.

Cómo funciona

Envíe un UUID en el header Idempotency-Key y Automeli recuerda la respuesta durante 24h. Reintentos posteriores con el mismo body devuelven la respuesta cacheada, sin volver a crear el job.

header

Idempotency-Key: 2c4e2f7a-8b1d-4e7c-9c4f-1d2e3f4a5b6c

→Misma key + mismo body: devuelve la respuesta original. Header Idempotent-Replay: true.
→Misma key + body distinto: 409 E_IDEMPOTENCY_CONFLICT.
→Key nueva: procesa normal y cachea.

Aplica a los endpoints de escritura idempotentes: POST /v1/products y POST /v1/products/test/promote. Reutilice la misma key solo para reintentar el mismo request, no para uno nuevo.