Ciclo de vida da tarefa
Inicie, anexe arquivos, processe, consulte e recupere tarefas de documentos.
Iniciar → anexar → processar → consultar → descarregar#
POST /v1/tasks: defina a operação uma vez.POST /v1/tasks/{task_id}/uploads: obtenha um ticket de upload direto assinado; use seu endpoint de conclusão para anexar o arquivo automaticamente.POST /v1/tasks/{task_id}/files: como alternativa, anexe uploads concluídos separadamente em ordem.POST /v1/tasks/{task_id}/process: submeter opções imutáveis e colocar uma tarefa cobrada na fila.GET /v1/tasks/{task_id}: inspecione o status de execução real.GET /v1/tasks/{task_id}/download-url: receba uma URL de saída assinada de curta duração quando bem-sucedido.
Listar tarefas com GET /v1/tasks?limit=20&offset=0, opcionalmente filtrando por ferramenta. Você pode descartar tarefas em espera com DELETE; trabalhos em processamento/concluídos não podem ser deletados ou cancelados por este endpoint.
{
"task_id": "uuid",
"tool": "compress",
"status": "waiting",
"upload_ids": [],
"job_id": null,
"progress": 0,
"output_ready": false,
"links": {
"self": "/v1/tasks/uuid",
"files": "/v1/tasks/uuid/files",
"process": "/v1/tasks/uuid/process"
}
}Idempotência#
O processamento usa uma chave interna derivada do identificador da tarefa. Reenvie opções idênticas para recuperar uma resposta perdida sem criar outra cobrança lógica. Alterar configurações após o envio retorna HTTP 409. A API de trabalho direto legada permanece suportada.
