PPDF123
Product3 хв читання

CLI pdfx: один каталог, викликаний із вашого термінала

CLI pdfx надсилає ті самі multipart-запити, що й curl, до API PDF123 або вашого pdfx-server і додає пакетні запуски, паролі для кожного файлу та коди виходу, на які може розгалужуватися скрипт.

By the PDF123 team · Updated 2026-09-29
CLI pdfx: один каталог, викликаний із вашого термінала

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 нульового розміру.

Куди йдуть байти

Файли завантажуються на базову адресу API, обробляються там і видаляються після надсилання відповіді. Це той самий контракт, що й у браузерної форми; CLI змінює клієнта, а не місце призначення. Для документів, які не повинні покидати вашу мережу, запустіть pdfx-server самі та спрямуйте --api-base на нього; це описано на сторінці Власний хостинг.

Офлайн-режиму, на який можна відступити, немає: якщо база недосяжна, команда завершується помилкою. pdfx — це мережевий клієнт, який просто зручний в оболонці, а не локальний рушій PDF.

Чим CLI не є

pdfx — не настільний графічний інтерфейс і не OCR-бібліотека, яку вбудовують у інший застосунок. Це клієнт командного рядка для операцій із PDF, тож разова задача людини все одно краще вирішується на порталі (Стиснути, OCR та решта каталогу), а будь-що, що потребує власного дерева інтерфейсу, відтворить проблему розходження, описану в статті Та сама операція, чотири клієнти.

Агенти отримують ті самі форми з опублікованої навички /skills/pdf123.md, яка повністю описує запити merge і pipeline. Для безпечних повторних спроб змінних POST надсилайте Idempotency-Key; CLI все одно робить один запит на виклик, тож цей заголовок належить тому, що його повторює (Idempotency-Key: безпечні повторні спроби для завдань PDF). Ключі, обмеження швидкості та коди помилок — на сторінці Розробникам.

Open tool
Process in the browser — no watermark, files removed after the job.
Open tool