Stav úlohy
GET /api/v1/jobs/{job_id}Dotaz pouze čte stav a neplatí žádné kredity.
curl https://omnidoc.top/api/v1/jobs/q3f8s6c2a9m1k4tx \ -H "X-API-Key: $OMNIDOC_API_KEY"Stavy životního cyklu
Section titled “Stavy životního cyklu”status | Význam |
|---|---|
pending | Vytvořeno, čeká ve frontě |
processing | Zpracovává se |
completed | Hotovo; výsledky lze přečíst |
failed | Nevydařilo se nebo bylo zrušeno; viz error_msg |
status vám sdělí, zda byl úkol ukončen.
Stupně pokroku
Section titled “Stupně pokroku”stage | Význam |
|---|---|
queued | Ve frontě |
accepted / preflight | Přijato a připravuje se |
translating | Překládání |
writing_artifacts / finalizing | Generování a registrace výsledků |
completed / failed | Ukončeno |
stage_progress je zobrazení průběhu od 0 do 100; nepoužívá se pro fakturaci. Když je v frontě, queue_position může uvádět počet úloh před ním nebo může být null.
Seznam a zrušení
Section titled “Seznam a zrušení”GET /api/v1/jobs?limit=20&before=2026-10-01T12:00:00ZPOST /api/v1/jobs/{job_id}/cancelZrušení je prováděno nejlepšími snahami; úloha, která již skončila, vrátí hodnotu 409. Za zrušené úlohy se neúčtuje žádná částka, což můžete potvrdit v registru kreditů.
Získejte výsledky
Section titled “Získejte výsledky”Po dokončení úlohy:
GET /api/v1/artifacts?job_id={job_id}Seznam výsledků je prázdný, zatímco úloha stále běží.