Κατάσταση εργασίας
GET /api/v1/jobs/{job_id}Μια ερώτηση μόνο διαβάζει την κατάσταση και δεν χρεώνει πιστώσεις.
curl https://omnidoc.top/api/v1/jobs/q3f8s6c2a9m1k4tx \ -H "X-API-Key: $OMNIDOC_API_KEY"Καταστάσεις κύκλου ζωής
Section titled “Καταστάσεις κύκλου ζωής”status | Σημασία |
|---|---|
pending | Δημιουργήθηκε, αναμένει στην ουρά |
processing | Επεξεργάζεται |
completed | Ολοκληρώθηκε· τα αποτελέσματα μπορούν να διαβαστούν |
failed | Απέτυχε ή ακυρώθηκε· βλ. error_msg |
Το status σας ενημερώνει για το αν η εργασία έχει ολοκληρωθεί.
Στάδια προόδου
Section titled “Στάδια προόδου”stage | Σημασία |
|---|---|
queued | Στην ουρά |
accepted / preflight | Αποδεκτό και ετοιμάζεται |
translating | Μεταφράζοντας |
writing_artifacts / finalizing | Δημιουργία και καταχώρηση των αποτελεσμάτων |
completed / failed | Τελείωσε |
Το stage_progress είναι μια πρόοδος εμφάνισης από το 0 έως το 100; δεν χρησιμοποιείται για χρέωση. Όσο βρίσκεται σε ουρά, το queue_position μπορεί να δείχνει τον αριθμό των εργασιών που βρίσκονται μπροστά, ή μπορεί να είναι null.
Κατάλογος και ακύρωση
Section titled “Κατάλογος και ακύρωση”GET /api/v1/jobs?limit=20&before=2026-10-01T12:00:00ZPOST /api/v1/jobs/{job_id}/cancelΗ ακύρωση είναι κατ’ ελάχιστον προσπάθεια· μια εργασία που έχει ήδη ολοκληρωθεί επιστρέφει 409. Δεν χρεώνονται ακυρωμένες εργασίες, γεγονός που μπορείτε να επιβεβαιώσετε στο αρχείο πιστώσεων.
Λάβετε τα αποτελέσματα
Section titled “Λάβετε τα αποτελέσματα”Μετά την ολοκλήρωση της εργασίας:
GET /api/v1/artifacts?job_id={job_id}Η λίστα αποτελεσμάτων είναι άδεια ενώ η εργασία εξακολουθεί να τρέχει.