跳转到内容

Εργαλεία εγγράφων και αρχείων

Το OmniDoc προσφέρει συγχρονισμένα εργαλεία αρχείων και δυνατότητα παρακολούθησης ασύγχρονων λειτουργιών εγγράφων. Καλέστε πρώτα τις κατάλληλες επισημάνσεις δυνατοτήτων· μην κωδικοποιείτε σταθερά τα υποστηριζόμενα φορμάτ ή τα όρια στην πελάτη.

GET /api/v1/document-operations/capabilities
GET /api/v1/artifacts/convert/capabilities

Αυτά επιστρέφουν τις λειτουργίες που είναι ανοιχτές, τις μορφές εισόδου τους, τα όρια χρέωσης και τεχνικά όρια. Οι δυνατότητες που αναφέρονται στο unavailable δεν μπορούν να δημιουργηθούν.

Ασύγχρονες λειτουργίες εγγράφων

Section titled “Ασύγχρονες λειτουργίες εγγράφων”
POST /api/v1/document-operations
Idempotency-Key: unique-request-id
{
"document_id": "4q8mx2q9z1k7p6ra",
"kind": "visual_extract"
}

Αυτή η διεπαφή χρειάζεται ένα Idempotency-Key. Το kind περιλαμβάνει αυτή τη στιγμή:

  • extract: δομημένη εξαγωγή, δωρεάν.
  • pdf_to_html: PDF στο διαδίκτυο HTML, δωρεάν.
  • visual_extract: οπτική δομημένη εξαγωγή, χρεώνεται ανά σελίδα (1 πιστώσεις ανά σελίδα). Πριν ξεκινήσει, ο αριθμός των σελίδων που μπορεί να επεξεργαστεί καθορίζεται από το υπόλοιπο (το πολύ 20 σελίδες); εάν το υπόλοιπο καλύπτει λιγότερες από 1 σελίδα, επιστρέφει 402. Όταν ολοκληρωθεί, χρεώνονται οι σελίδες που επεξεργάστηκε πραγματικά και το υπόλοιπο μπορεί να γίνει αρνητικό.

Αναζήτηση και ακύρωση:

GET /api/v1/document-operations/{operation_id}
GET /api/v1/document-operations?limit=25
POST /api/v1/document-operations/{operation_id}/cancel

Όταν ολοκληρωθεί, το output_document_id της απόκρισης μπορεί να αποθηκευτεί στη βιβλιοθήκη αρχείων ή σε άλλη εργασία, και το credit_operation_id παρέχει την καταχώρηση εκκαθάρισης.

POST /api/v1/file-tools/pdf/merge
POST /api/v1/file-tools/pdf/split
POST /api/v1/file-tools/pdf/compress

Παράδειγμα συγχώνευσης:

{"document_ids":["4q8mx2q9z1k7p6ra","b6t1n8c3v9m2x5ka"]}

Παράδειγμα διασποράς:

{"document_id":"4q8mx2q9z1k7p6ra","ranges":["1-3","5","8-10"]}
POST /api/v1/file-tools/image/convert
POST /api/v1/file-tools/image/compress
{
"document_id": "4q8mx2q9z1k7p6ra",
"target_format": "webp",
"quality": 85
}

Τα εργαλεία δέχονται μόνο έγγραφα που ανήκουν στον τρέχοντα λογαριασμό και των οποίων ο τύπος ταιριάζει. Αποστείλετε δυαδικές αποκρίσεις και πάρτε το όνομα αρχείου και τον τύπο από τα πεδία της απόκρισης.