État du travail
GET /api/v1/jobs/{job_id}Une requête ne fait que lire l’état et n’occasionne aucun crédit.
curl https://omnidoc.top/api/v1/jobs/q3f8s6c2a9m1k4tx \ -H "X-API-Key: $OMNIDOC_API_KEY"États du cycle de vie
Section intitulée « États du cycle de vie »status | Signification |
|---|---|
pending | Créé, en attente dans la file d’attente |
processing | En cours de traitement |
completed | Terminé ; les résultats peuvent être consultés. |
failed | Échec ou annulation ; voir error_msg |
status indique si le travail s’est terminé.
Phases d’avancement
Section intitulée « Phases d’avancement »stage | Signification |
|---|---|
queued | Dans la file d’attente |
accepted / preflight | Accepté et en préparation |
translating | Traduction |
writing_artifacts / finalizing | Génération et enregistrement des résultats |
completed / failed | Terminé |
stage_progress est une progression d’affichage allant de 0 à 100 ; il n’est pas utilisé pour la facturation. Lorsqu’il est en file d’attente, queue_position peut indiquer le nombre de travaux précédents, ou bien être null.
Lister et annuler
Section intitulée « Lister et annuler »GET /api/v1/jobs?limit=20&before=2026-10-01T12:00:00ZPOST /api/v1/jobs/{job_id}/cancelL’annulation est effectuée au meilleur effort ; un job déjà terminé renvoie 409. Les jobs annulés ne sont pas facturés, ce que vous pouvez vérifier dans l’historique des crédits.
Obtenez les résultats
Section intitulée « Obtenez les résultats »Une fois le travail terminé :
GET /api/v1/artifacts?job_id={job_id}La liste des résultats est vide alors que le travail est toujours en cours d’exécution.