Idempotência
Repita após timeout sem gerar nem cobrar duas vezes.
createTask e retry aceitam o cabeçalho Idempotency-Key. Em createTask, a chave fica vinculada à solicitação lógica da conta; em retry, à tarefa de origem e à ação de nova tentativa. Isso evita gerações e cobranças duplicadas.
POST /api/v1/jobs/createTask
Idempotency-Key: order-8814-render-1
POST /api/v1/jobs/retry
Idempotency-Key: retry-order-8814-1Janela de 24 horas
A chave vale por 24 horas. Crie uma por solicitação lógica e reutilize-a em todas as tentativas, inclusive após timeout de rede. O tamanho máximo é 128 caracteres.
A chave vincula a solicitação
O hash inclui model, input canônico, callBackUrl. A mesma chave com outro payload retorna HTTP 409. Mudar apenas a ordem das chaves JSON ou os espaços continua sendo a mesma solicitação.
Envios simultâneos
Uma restrição única no banco garante uma única tarefa quando duas solicitações chegam juntas. Na situação rara de concorrência com resposta 409, espere algumas centenas de milissegundos e tente novamente com a mesma chave. Consulte o estado atual por recordInfo usando o taskId recebido.
Consulte o contrato OpenAPI 3.1 para ver a definição completa dos campos.