Ciclo de vida de tarea
Inicia, adjunta archivos, procesa, consulta y recupera tareas de documentos.
Iniciar → adjuntar → procesar → sondear → descargar#
POST /v1/tasks: establezca la operación una sola vez.POST /v1/tasks/{task_id}/uploads: obtén un ticket de carga directa firmado; usa su endpoint de finalización para adjuntar el archivo automáticamente.POST /v1/tasks/{task_id}/files: alternativamente adjunta cargas completadas por separado en orden.POST /v1/tasks/{task_id}/process: envía opciones inmutables y pone en cola un trabajo cobrado.GET /v1/tasks/{task_id}: inspecciona el estado de ejecución real.GET /v1/tasks/{task_id}/download-url: recibe una URL de salida firmada de corta duración cuando es exitoso.
Listar tareas con GET /v1/tasks?limit=20&offset=0, opcionalmente filtrando por herramienta. Puedes descartar tareas en espera con DELETE; los trabajos en procesamiento/completados no pueden ser eliminados o 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"
}
}Idempotencia#
El procesamiento utiliza una clave interna derivada del identificador de tarea. Reenvía opciones idénticas para recuperar una respuesta perdida sin crear otro cargo lógico. Cambiar configuración después del envío devuelve HTTP 409. La API de trabajo directo heredada sigue siendo compatible.
