pdfx CLI: tek katalog, terminalinizden çağırın
pdfx CLI, curl’ün göndereceği multipart isteklerini PDF123 API’sine ya da kendi pdfx-server’ınıza gönderir; toplu çalıştırma, dosya başına parola ve betiğin dallanabileceği çıkış kodları ekler.

Ürün adı PDF123. pdfx aynı işlem kataloğunun bir kabuk sarmalayıcısıdır: curl’ün kuracağı multipart isteğini kurar, seçtiğiniz API tabanına gönderir ve sonucu dosyalarınızın yanına yazar. Merge, Compress, OCR ve kataloğun geri kalanı bu yoldan çağrılabilir.
Bir çağrı aslında ne gönderir
pdfx --api-base "$API_BASE" --api-key "$PDFX_API_KEY" \
merge a.pdf b.pdf -o merged.pdf
--api-base varsayılanı https://pdf123.xyz’tir; --api-key (ya da PDFX_API_KEY ortam değişkeni) isteğe bağlıdır, yani anonim katalog onsuz da çalışır. Tabanı kendi docker-compose yığınınız için http://127.0.0.1:8080 adresine çevirin. Altında ikinci bir protokol yok: CLI, Geliştiriciler sayfasında belgelenen REST yüzeyinin bir istemcisidir ve işlem adları portal araçlarıyla ve /v1/openapi.json adresindeki OpenAPI belgesiyle hizalanır.
Katalog, terminalden çıkmadan keşfedilebilir. pdfx list her aracı, pdfx describe add-stamp tek bir aracın alanlarını ve varsayılanlarını yazdırır; bu, portalın form olarak işlediği tanımın aynısıdır.
Toplu çalıştırmalar ve curl’ün size yazdırdığı bayraklar
Tek dosyalık bir araca birden çok girdi verin; bunları -o dizinine bir toplu iş olarak çalıştırır ve her dosya için bir input -> saved satırı yazdırır. Hatalar stderr’e gider, kalan dosyalar yine tamamlanır; böylece bir fatura klasöründeki tek bozuk PDF işi iptal etmez. --concurrency <n> aynı anda kaç dosyanın işlendiğini belirler (varsayılan 2).
-o bir dosya ya da dizin alır ve var olan bir dosyanın üzerine asla yazmaz; dizin içinde sunucunun verdiği dosya adını kullanır. Bu, sunucu sonucu girdiye göre adlandırdığında önemlidir: aksi hâlde bir çalıştırma, az önce yüklediğiniz PDF’in üzerine yazardı.
Şifreli girdiler istekten önce açılır, araç tarafından değil: --input-password çalıştırmadaki her dosyayı kapsar, --password-for report.pdf=secret tek bir dosyanın parolasını belirler ve yinelenebilir; * geri kalanı temsil eder. Böylece kilitli ve açık dosyaları karıştıran bir toplu iş elle sıralama gerektirmez. --json her sonuç için { path, contentType, bytes }, bir toplu iş için [{ input, ok, path | error, reason }] yazdırır; böylece bir sarmalayıcı, insan tarafından okunabilen satırları kazımak yerine sonucu ayrıştırabilir.
Betiğin dallanabileceği çıkış kodları
0 başarı demektir, 1 bir isteğin başarısız olduğunu (toplu işte: en az bir dosya), 2 hiçbir şeyin yüklenmediği bir kullanım hatasını, 130 ise süreci kestiğinizi ve uçuştaki isteğin iptal edildiğini gösterir. Hatalar, mevcut olduğunda iletinin altında reason:, code: ve hint: satırlarını yazdırır; bir betiğin düzyazı yerine eşlemesi gereken bunlardır.
Bir çıkışı yanlış okumak kolaydır. Döndürecek bir şey bulamayan bir araç, boş bir dosya yazmak yerine code: no_content ile sıfırdan farklı çıkar; yani tablosu olmayan bir PDF üzerinde pdf-to-csv bir başarısızlıktır, sıfır baytlık bir CSV değil.
Baytlar nereye gider
Dosyalar API tabanına yüklenir, orada işlenir ve yanıt gönderildikten sonra silinir. Bu, tarayıcı formuyla aynı sözleşmedir; CLI istemciyi değiştirir, varış yerini değil. Ağınızdan çıkmaması gereken belgeler için kendi pdfx-server’ınızı çalıştırıp --api-base adresini ona yöneltin; bu, Self-host sayfasında anlatılır.
Geri düşülecek bir çevrimdışı kip yoktur: taban erişilemezse komut başarısız olur. pdfx, kabukta kullanışlı olan bir ağ istemcisidir; yerel bir PDF motoru değil.
CLI ne değildir
pdfx bir masaüstü GUI’si ve başka bir uygulamaya bağlayacağınız gömülebilir bir OCR kitaplığı değildir. PDF işlemleri için bir komut satırı istemcisidir; bu yüzden insan eliyle yapılan tek seferlik bir iş için yine portal daha uygundur (Compress, OCR ve kataloğun geri kalanı) ve kendi UI ağacına ihtiyaç duyan her şey, Aynı işlem, dört istemci yazısında anlatılan sapma sorununu yeniden yaratır.
Ajanlar aynı biçimleri, merge ve pipeline isteklerini eksiksiz belgeleyen yayımlanmış beceriden /skills/pdf123.md alır. Değiştirici POST’ların güvenli yeniden denemeleri için Idempotency-Key gönderin; CLI her çağrıda yine tek bir istek yapar, yani bu başlık onu yeniden deneyen her ne ise ona aittir (Idempotency-Key: PDF işleri için güvenli yeniden denemeler). Anahtarlar, hız sınırları ve hata kodları Geliştiriciler sayfasındadır.