Idempotencia
Reintenta tras un timeout sin generar ni cobrar dos veces.
createTask y retry admiten la cabecera Idempotency-Key. En createTask la clave se vincula a la solicitud lógica de la cuenta; en retry, a la tarea de origen y a la acción de reintento. Así se evitan generaciones y cargos duplicados.
POST /api/v1/jobs/createTask
Idempotency-Key: order-8814-render-1
POST /api/v1/jobs/retry
Idempotency-Key: retry-order-8814-1Ventana de 24 horas
La clave dura 24 horas. Crea una por solicitud lógica y reutilízala en todos los reintentos, también después de un timeout de red. La longitud máxima es de 128 caracteres.
La clave vincula la solicitud
La huella incluye model, input canónico, callBackUrl. La misma clave con otro payload devuelve HTTP 409. Cambiar solo el orden de claves JSON o el espacio en blanco sigue siendo la misma solicitud.
Envíos simultáneos
Una restricción única de base de datos garantiza una sola tarea cuando dos solicitudes llegan a la vez. Ante la rara carrera 409, espera unos cientos de milisegundos y repite con la misma clave. Consulta el estado actual con recordInfo y el taskId recibido.
Consulta el contrato OpenAPI 3.1 para ver la definición completa de los campos.