pdfx CLI: แคตตาล็อกเดียว เรียกจากเทอร์มินัลของคุณ
pdfx CLI ส่งคำขอ multipart แบบเดียวกับ curl ไปยัง API ของ PDF123 หรือ pdfx-server ของคุณเอง พร้อมเพิ่มการรันแบบกลุ่ม รหัสผ่านรายไฟล์ และรหัสออกที่สคริปต์ใช้ตัดสินใจได้

PDF123 คือชื่อผลิตภัณฑ์ ส่วน pdfx คือแคตตาล็อกการดำเนินการชุดเดียวกันที่ห่อมาเพื่อเชลล์ มันสร้างคำขอ multipart แบบเดียวกับที่ curl จะสร้าง ส่งไปยัง base URL ที่คุณเลือก และเขียนผลลัพธ์ไว้ข้างไฟล์ของคุณ รวมไฟล์ บีบอัด 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) เป็นตัวเลือก จึงใช้แคตตาล็อกแบบไม่ระบุตัวตนได้โดยไม่ต้องมีคีย์ ชี้ base ไปที่ http://127.0.0.1:8080 สำหรับสแตก docker-compose ของคุณเอง ไม่มีโปรโตคอลที่สองอยู่ข้างใต้ CLI เป็นไคลเอนต์ของพื้นผิว REST ที่อธิบายใน Developers และชื่อ op ตรงกับเครื่องมือในพอร์ทัลและเอกสาร OpenAPI ที่ /v1/openapi.json
สำรวจแคตตาล็อกได้โดยไม่ต้องออกจากเทอร์มินัล pdfx list พิมพ์ทุกเครื่องมือ และ pdfx describe add-stamp พิมพ์ฟิลด์และค่าเริ่มต้นของเครื่องมือหนึ่งตัว ซึ่งเป็นนิยามเดียวกับที่พอร์ทัลเรนเดอร์เป็นฟอร์ม
การรันแบบกลุ่ม และ flag ที่ 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 ขนาดศูนย์ไบต์
ไบต์ไปที่ไหน
ไฟล์ถูกอัปโหลดไปยัง base URL ประมวลผลที่นั่น และลบทิ้งเมื่อส่งคำตอบแล้ว นั่นคือสัญญาเดียวกับฟอร์มในเบราว์เซอร์ CLI เปลี่ยนไคลเอนต์ ไม่ได้เปลี่ยนปลายทาง สำหรับเอกสารที่ห้ามออกจากเครือข่ายของคุณ ให้รัน pdfx-server เองแล้วชี้ --api-base ไปที่มัน ซึ่งอธิบายไว้ที่ Self-host
ไม่มีโหมดออฟไลน์ให้ถอยกลับ ถ้า base เข้าถึงไม่ได้ คำสั่งก็ล้มเหลว pdfx เป็นไคลเอนต์เครือข่ายที่บังเอิญใช้ในเชลล์ได้สบาย ไม่ใช่เอนจิน PDF ในเครื่อง
CLI ไม่ใช่อะไร
pdfx ไม่ใช่ GUI เดสก์ท็อป และไม่ใช่ไลบรารี OCR ที่ฝังในแอปอื่น มันคือไคลเอนต์บรรทัดคำสั่งสำหรับงาน PDF งานมือแบบครั้งเดียวจึงยังเหมาะกับพอร์ทัลมากกว่า (บีบอัด OCR และเครื่องมืออื่นในแคตตาล็อก) และอะไรก็ตามที่ต้องการโครง UI ของตัวเองจะสร้างปัญหาเรื่องความคลาดเคลื่อนที่อธิบายใน ปฏิบัติการเดียวกัน สี่ไคลเอนต์
เอเจนต์ได้รูปทรงเดียวกันจากสกิลที่เผยแพร่ที่ /skills/pdf123.md ซึ่งอธิบายคำขอ merge และ pipeline อย่างครบถ้วน สำหรับการลองใหม่ที่ปลอดภัยของ POST ที่เปลี่ยนสถานะ ให้ส่ง Idempotency-Key CLI ยังคงส่งหนึ่งคำขอต่อการเรียกหนึ่งครั้ง เฮดเดอร์นี้จึงเป็นของตัวห่อที่ลองใหม่ (Idempotency-Key: การลองใหม่ที่ปลอดภัยสำหรับงาน PDF) คีย์ ข้อจำกัดอัตรา และรหัสข้อผิดพลาดอยู่ที่ Developers