Cycle de vie des tâches
Démarrez, importez des fichiers, traitez, interrogez et récupérez les tâches de document.
Démarrer → joindre → traiter → interroger → télécharger#
POST /v1/tasks: définir l'opération une seule fois.POST /v1/tasks/{task_id}/uploads: obtenir un ticket d'importation direct signé ; utiliser son endpoint de completion pour joindre le fichier automatiquement.POST /v1/tasks/{task_id}/files: vous pouvez également joindre séparément les importations complétées dans l'ordre.POST /v1/tasks/{task_id}/process: soumettre des options immuables et mettre en file d'attente une tâche facturée.GET /v1/tasks/{task_id}: inspectez le statut d'exécution réel.GET /v1/tasks/{task_id}/download-url: recevez une URL de sortie signée de courte durée en cas de succès.
Lister les tâches avec GET /v1/tasks?limit=20&offset=0, en filtrant optionnellement par outil. Vous pouvez supprimer les tâches en attente avec DELETE ; les tâches en cours de traitement ou terminées ne peuvent pas être supprimées ou annulées par ce point de terminaison.
{
"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"
}
}Idempotence#
Le traitement utilise une clé interne dérivée de l'identifiant de tâche. Renvoyez les options identiques pour récupérer une réponse perdue sans créer de charge logique supplémentaire. Modifier les paramètres après la soumission retourne HTTP 409. L'API de tâche directe héritée reste prise en charge.
