Logo PDFHQ

Documents

DocumentationMise en route

Cycle de vie des tâches

Démarrez, importez des fichiers, traitez, interrogez et récupérez les tâches de document.

Clés API côté serveur Importations de stockage signées

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.

Démarrer la réponse de tâche (représentatif)
{
  "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.

Logo PDFHQ

Outils PDF et intelligence documentaire. Préparez, comprenez et travaillez avec vos documents.

© 2026 PDFHQ. Tous droits réservés.