pdfx CLI: един каталог, извикван от вашия терминал
pdfx CLI изпраща същите 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 повърхността, документирана на Developers, а имената на операциите съвпадат с инструментите в портала и с 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 с нула байта.
Къде отиват байтовете
Файловете се качват към базовия адрес на API, обработват се там и се изтриват, щом отговорът бъде изпратен. Това е същият договор като при формуляра в браузъра: CLI сменя клиента, не дестинацията. За документи, които не бива да напускат мрежата ви, пуснете pdfx-server сами и насочете --api-base към него, което е описано в Self-host.
Няма офлайн режим, към който да се върнете: ако базата е недостъпна, командата се проваля. pdfx е мрежов клиент, който просто е приятен в команден ред, а не локален PDF механизъм.
Какво CLI не е
pdfx не е настолен графичен интерфейс и не е вграждаща се OCR библиотека, която да свържете в друго приложение. Той е клиент от командния ред за PDF операции, така че еднократна човешка задача пак се обслужва по-добре от портала (Компресиране, OCR и останалите от каталога), а всичко, което се нуждае от собствено дърво на интерфейса, би пресъздало проблема с разминаването, описан в Една и съща операция, четири клиента.
Агентите получават същите форми от публикувания skill на адрес /skills/pdf123.md, който документира изцяло заявките за merge и pipeline. За безопасни повторни опити на променящи POST заявки изпращайте Idempotency-Key; CLI все още прави по една заявка на извикване, така че заглавката принадлежи на това, което повтаря (Idempotency-Key: безопасни повторни опити за PDF задачи). Ключовете, ограниченията на честотата и кодовете за грешка са на Developers.