Ciclo di vita dell'attività
Avvia, allega file, elabora, esegui il polling e recupera attività di documenti.
Avvia → allega → elabora → sonda → scarica#
POST /v1/tasks: impostare l'operazione una sola volta.POST /v1/tasks/{task_id}/uploads: ottenere un ticket di caricamento diretto firmato; utilizzare il relativo endpoint di completamento per allegare il file automaticamente.POST /v1/tasks/{task_id}/files: in alternativa allega separatamente i caricamenti completati in ordine.POST /v1/tasks/{task_id}/process: invia opzioni immutabili e accoda un job addebitato.GET /v1/tasks/{task_id}: ispeziona lo stato di esecuzione reale.GET /v1/tasks/{task_id}/download-url: ricevi un URL di output firmato di breve durata in caso di successo.
Elenca attività con GET /v1/tasks?limit=20&offset=0, filtrando facoltativamente per strumento. Puoi scartare le attività in sospeso con DELETE; i job in elaborazione/completati non possono essere eliminati o annullati da questo 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"
}
}Idempotenza#
L'elaborazione utilizza una chiave interna derivata dall'identificatore dell'attività. Invia di nuovo opzioni identiche per recuperare una risposta persa senza creare un altro addebito logico. La modifica delle impostazioni dopo l'invio restituisce HTTP 409. L'API legacy del job diretto rimane supportata.
