Το CLI pdfx: ένας κατάλογος, καλούμενος από το τερματικό σας
Το CLI pdfx στέλνει τα ίδια αιτήματα multipart όπως το curl στο API του PDF123 ή στον δικό σας pdfx-server, και προσθέτει μαζικές εκτελέσεις, κωδικούς ανά αρχείο και κωδικούς εξόδου στους οποίους μπορεί να διακλαδωθεί ένα σενάριο.

Το PDF123 είναι το όνομα του προϊόντος. Το pdfx είναι ο ίδιος κατάλογος λειτουργιών τυλιγμένος για ένα κέλυφος: χτίζει το αίτημα multipart που θα είχε χτίσει το curl, το στέλνει στη βάση του API που επιλέγετε και γράφει το αποτέλεσμα δίπλα στα αρχεία σας. Η Συγχώνευση, η Συμπίεση, το OCR και τα υπόλοιπα του καταλόγου καλούνται με αυτόν τον τρόπο.
Τι στέλνει στην πραγματικότητα μια κλήση
pdfx --api-base "$API_BASE" --api-key "$PDFX_API_KEY" \
merge a.pdf b.pdf -o merged.pdf
Το --api-base έχει προεπιλογή το https://pdf123.xyz, και το --api-key (ή η μεταβλητή περιβάλλοντος PDFX_API_KEY) είναι προαιρετικό, ώστε ο ανώνυμος κατάλογος να λειτουργεί και χωρίς αυτό. Στρέψτε τη βάση στο http://127.0.0.1:8080 για δική σας στοίβα docker-compose. Από κάτω δεν υπάρχει δεύτερο πρωτόκολλο: το CLI είναι πελάτης της επιφάνειας REST που τεκμηριώνεται στους Προγραμματιστές, και τα ονόματα των λειτουργιών του συμβαδίζουν με τα εργαλεία της πύλης και με το έγγραφο OpenAPI στο /v1/openapi.json.
Ο κατάλογος είναι ανακαλύψιμος χωρίς να αφήσετε το τερματικό. Το pdfx list εκτυπώνει κάθε εργαλείο και το pdfx describe add-stamp εκτυπώνει τα πεδία και τις προεπιλογές ενός εργαλείου, δηλαδή τον ίδιο ορισμό που η πύλη αποδίδει ως φόρμα.
Μαζικές εκτελέσεις και οι παράμετροι που το curl σας αφήνει να γράψετε μόνοι
Δώστε σε ένα εργαλείο ενός αρχείου πολλές εισόδους και τις εκτελεί ως μαζική παρτίδα μέσα στον κατάλογο -o, εκτυπώνοντας μία γραμμή input -> saved ανά αρχείο. Οι αποτυχίες πηγαίνουν στο stderr και τα υπόλοιπα αρχεία ολοκληρώνονται κανονικά, ώστε ένα χαλασμένο PDF σε έναν φάκελο τιμολογίων να μην ακυρώνει την εκτέλεση. Το --concurrency <n> ορίζει πόσα αρχεία βρίσκονται σε επεξεργασία ταυτόχρονα (προεπιλογή 2).
Το -o δέχεται αρχείο ή κατάλογο και δεν αντικαθιστά ποτέ υπάρχον αρχείο, αλλά χρησιμοποιεί το όνομα που δίνει ο διακομιστής στο αποτέλεσμα μέσα στον κατάλογο. Αυτό έχει σημασία όταν ο διακομιστής ονομάζει το αποτέλεσμα από την είσοδο: χωρίς αυτό, μια εκτέλεση θα αντικαθιστούσε το PDF που μόλις ανεβάσατε.
Οι κρυπτογραφημένες είσοδοι ανοίγουν πριν από το αίτημα, όχι από το εργαλείο: το --input-password καλύπτει κάθε αρχείο της εκτέλεσης, και το --password-for report.pdf=secret ορίζει τον κωδικό ενός αρχείου και μπορεί να επαναληφθεί, με το * να στέκεται για τα υπόλοιπα. Έτσι μια παρτίδα που αναμειγνύει κλειδωμένα και ανοιχτά αρχεία δεν χρειάζεται χειροκίνητη ταξινόμηση. Το --json εκτυπώνει { path, contentType, bytes } ανά αποτέλεσμα, ή [{ input, ok, path | error, reason }] για μια παρτίδα, ώστε ένα περιτύλιγμα να αναλύει το αποτέλεσμα αντί να ξύνει τις ανθρώπινα αναγνώσιμες γραμμές.
Κωδικοί εξόδου στους οποίους μπορεί να διακλαδωθεί ένα σενάριο
Το 0 σημαίνει επιτυχία, το 1 σημαίνει ότι ένα αίτημα απέτυχε (σε παρτίδα: τουλάχιστον ένα αρχείο), το 2 είναι σφάλμα χρήσης όπου δεν ανέβηκε τίποτα, και το 130 σημαίνει ότι το διακόψατε και το αίτημα σε εξέλιξη ακυρώθηκε. Οι αποτυχίες εκτυπώνουν γραμμές reason:, code: και hint: κάτω από το μήνυμα όποτε είναι διαθέσιμες, και σε αυτές πρέπει να ταιριάζει ένα σενάριο, όχι στην πεζογραφία.
Μια έξοδος διαβάζεται εύκολα λάθος. Ένα εργαλείο που δεν βρίσκει τίποτα να επιστρέψει βγαίνει με μη μηδενικό κωδικό και code: no_content αντί να γράψει ένα κενό αρχείο, ώστε το pdf-to-csv σε ένα PDF χωρίς πίνακες να είναι αποτυχία, όχι CSV μηδενικών byte.
Πού πάνε τα byte
Τα αρχεία ανεβαίνουν στη βάση του API, επεξεργάζονται εκεί και διαγράφονται μόλις σταλεί η απάντηση. Αυτό είναι το ίδιο συμβόλαιο με τη φόρμα του φυλλομετρητή: το CLI αλλάζει τον πελάτη, όχι τον προορισμό. Για έγγραφα που δεν πρέπει να φύγουν από το δίκτυό σας, τρέξτε μόνοι σας έναν pdfx-server και στρέψτε το --api-base προς αυτόν, κάτι που καλύπτεται στην Αυτο-φιλοξενία.
Δεν υπάρχει λειτουργία εκτός σύνδεσης για υποχώρηση: αν η βάση δεν είναι προσβάσιμη, η εντολή αποτυγχάνει. Το pdfx είναι πελάτης δικτύου που τυχαίνει να είναι ευχάριστος σε ένα κέλυφος, όχι τοπική μηχανή PDF.
Τι δεν είναι το CLI
Το pdfx δεν είναι γραφικό περιβάλλον για υπολογιστή ούτε βιβλιοθήκη OCR που ενσωματώνεται σε άλλη εφαρμογή. Είναι πελάτης γραμμής εντολών για λειτουργίες PDF, ώστε μια μεμονωμένη ανθρώπινη εργασία να εξυπηρετείται καλύτερα από την πύλη (Συμπίεση, OCR και τα υπόλοιπα του καταλόγου), και ό,τι χρειάζεται δικό του δέντρο διεπαφής θα επανέφερε το πρόβλημα απόκλισης που περιγράφεται στο Ίδια λειτουργία, τέσσερις πελάτες.
Οι πράκτορες παίρνουν τα ίδια σχήματα από τη δημοσιευμένη δεξιότητα στο /skills/pdf123.md, που τεκμηριώνει πλήρως τα αιτήματα συγχώνευσης και αγωγού. Για ασφαλείς επαναλήψεις μεταλλακτικών POST, στείλτε Idempotency-Key· το CLI εξακολουθεί να κάνει ένα αίτημα ανά κλήση, οπότε η κεφαλίδα ανήκει σε ό,τι το επαναλαμβάνει (ασφαλείς επαναλήψεις για εργασίες PDF). Τα κλειδιά, τα όρια ρυθμού και οι κωδικοί σφάλματος βρίσκονται στους Προγραμματιστές.