pdfx CLI: één catalogus, aangeroepen vanuit uw terminal
De pdfx CLI stuurt dezelfde multipart-verzoeken als curl naar de PDF123 API of uw eigen pdfx-server, en voegt batchruns, wachtwoorden per bestand en exitcodes toe waarop een script kan vertakken.

PDF123 is de productnaam. pdfx is dezelfde catalogus van bewerkingen, verpakt voor een shell: het bouwt het multipart-verzoek dat curl zou bouwen, stuurt het naar de API-basis die u kiest en schrijft het resultaat naast uw bestanden. Merge, Compress, OCR en de rest van de catalogus zijn zo aan te roepen.
Wat een aanroep werkelijk verstuurt
pdfx --api-base "$API_BASE" --api-key "$PDFX_API_KEY" \
merge a.pdf b.pdf -o merged.pdf
--api-base valt standaard terug op https://pdf123.xyz, en --api-key (of de omgevingsvariabele PDFX_API_KEY) is optioneel, dus de anonieme catalogus werkt zonder. Richt de basis op http://127.0.0.1:8080 voor een eigen docker-compose-stack. Er zit geen tweede protocol onder: de CLI is een client van het REST-oppervlak dat op Developers staat, en de opnamen komen overeen met de portaltools en het OpenAPI-document op /v1/openapi.json.
De catalogus is te ontdekken zonder de terminal te verlaten. pdfx list print elke tool en pdfx describe add-stamp print de velden en standaardwaarden van één tool, dezelfde definitie die de portal als formulier toont.
Batchruns en de opties die u bij curl zelf schrijft
Geef een tool voor één bestand meerdere invoer en hij voert ze als een batch uit naar de map -o, met één regel input -> saved per bestand. Fouten gaan naar stderr en de overige bestanden lopen nog steeds af, dus één kapotte PDF in een map met facturen breekt de hele run niet af. --concurrency <n> stelt in hoeveel bestanden tegelijk onderweg zijn (standaard 2).
-o accepteert een bestand of een map en overschrijft nooit een bestaand bestand; in een map gebruikt het de bestandsnaam van de server. Dat maakt uit wanneer de server het resultaat naar de invoer vernoemt: zonder dat zou een run de PDF die u net hebt geüpload overschrijven.
Versleutelde invoer wordt vóór het verzoek geopend, niet door de tool: --input-password dekt elk bestand in de run, en --password-for report.pdf=secret stelt het wachtwoord van één bestand in en mag worden herhaald, waarbij * voor de rest staat. Een batch met vergrendelde en open bestanden hoeft dus niet handmatig gesorteerd te worden. --json print { path, contentType, bytes } per resultaat, of [{ input, ok, path | error, reason }] voor een batch, zodat een omhulsel de uitkomst kan parsen in plaats van de voor mensen leesbare regels te schrapen.
Exitcodes waarop een script kan vertakken
0 betekent succes, 1 betekent dat een verzoek mislukte (in een batch: minstens één bestand), 2 is een gebruiksfout waarbij niets is geüpload, en 130 betekent dat u het hebt onderbroken en het lopende verzoek is afgebroken. Fouten printen regels reason:, code: en hint: onder het bericht wanneer die beschikbaar zijn; daarop moet een script matchen, niet op proza.
Eén exitcode is makkelijk te mislezen. Een tool die niets te retourneren vindt, eindigt non-zero met code: no_content in plaats van een leeg bestand te schrijven, dus pdf-to-csv op een PDF zonder tabellen is een fout, geen CSV van nul bytes.
Waar de bytes heen gaan
De bestanden worden naar de API-basis geüpload, daar verwerkt en verwijderd zodra het antwoord is verzonden. Dat is hetzelfde contract als het browserformulier; de CLI verandert de client, niet de bestemming. Voor documenten die uw netwerk niet mogen verlaten, draait u zelf een pdfx-server en richt u --api-base daarop, wat op Self-host wordt behandeld.
Er is geen offlinemodus om op terug te vallen: als de basis onbereikbaar is, mislukt de opdracht. pdfx is een netwerkclient die toevallig prettig is in een shell, geen lokale PDF-engine.
Wat de CLI niet is
pdfx is geen desktop-GUI en geen inbedbare OCR-bibliotheek die u in een andere app linkt. Het is een command-lineclient voor PDF-bewerkingen, dus een eenmalige menselijke taak is nog steeds beter af bij de portal (Compress, OCR en de rest van de catalogus), en alles wat een eigen UI-boom nodig heeft, zou het driftprobleem uit Same operation, four clients opnieuw creëren.
Agents krijgen dezelfde vormen uit de gepubliceerde skill op /skills/pdf123.md, die de merge- en pipeline-verzoeken volledig documenteert. Stuur voor veilige nieuwe pogingen van wijzigende POST's een Idempotency-Key mee; de CLI doet nog steeds één verzoek per aanroep, dus de header hoort bij wat er ook opnieuw probeert (Idempotency-Key: Safe Retries for PDF Jobs). Sleutels, rate limits en foutcodes staan op Developers.