تخطَّ إلى المحتوى

حالة الوظيفة

GET /api/v1/jobs/{job_id}

لا تستهلك الاستعلام سوى قراءة الحالة ولا تُستخدم أي رصيد.

Terminal window
curl https://omnidoc.top/api/v1/jobs/q3f8s6c2a9m1k4tx \
-H "X-API-Key: $OMNIDOC_API_KEY"
statusالمعنى
pendingتم الإنشاء، في انتظار المعالجة في قائمة الانتظار
processingجارٍ المعالجة
completedتم الانتهاء؛ يمكن قراءة النتائج
failedفشل أو أُلغي؛ راجع error_msg

يُخبرك status بما إذا كانت المهمة قد انتهت.

stageالمعنى
queuedفي قائمة الانتظار
accepted / preflightمقبول وجاهز للإعداد
translatingالترجمة
writing_artifacts / finalizingإنشاء النتائج وتسجيلها
completed / failedانتهى

stage_progress هو شريط تقدم يعرض الحالة من 0 إلى 100؛ ولا يُستخدم في الفوترة. أثناء الانتظار في قائمة الانتظار، قد يعرض queue_position عدد الوظائف المتقدمة، أو قد يكون null.

GET /api/v1/jobs?limit=20&before=2026-10-01T12:00:00Z
POST /api/v1/jobs/{job_id}/cancel

الإلغاء يتم بجهد مبذول؛ الوظيفة التي انتهت بالفعل تُرجع 409. لا تُفرض رسوم على الوظائف الملغاة، ويمكنك التحقق من ذلك في سجل الائتمان.

بعد اكتمال المهمة:

GET /api/v1/artifacts?job_id={job_id}

قائمة النتائج فارغة بينما لا تزال المهمة قيد التنفيذ.