Está viendo la documentación de la API v1 (versión anterior). v1 sigue funcionando sin cambios hasta el 31 de enero de 2027, fecha en la que se apagará. Las integraciones nuevas deben usar la API v2, que cubre todo lo de v1 con nombres limpios y paginación por cursor. Si ya integró con v1, la guía de migración lista las equivalencias campo por campo.
Guía
Idempotencia
Si su sistema reintenta requests por timeouts de red, evite duplicar jobs con un Idempotency-Key.
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.