ProductDakika 3 za kusoma

pdfx CLI: Katalogi Moja, Inayoitwa Kutoka Terminal Yako

pdfx CLI hutuma maombi yale yale ya multipart kama curl kwa API ya PDF123 au pdfx-server yako mwenyewe, na kuongeza makundi, funguo kwa kila faili na misimbo ya kutoka ambayo hati ya maandishi inaweza kutumia.

By the PDF123 team Β· Updated 2026-09-29
pdfx CLI: Katalogi Moja, Inayoitwa Kutoka Terminal Yako

PDF123 ni jina la bidhaa. pdfx ni katalogi hiyo hiyo ya operesheni iliyofungwa kwa shell: huunda ombi la multipart ambalo curl lingeunda, huituma kwa URL ya msingi unayochagua, na kuandika tokeo kando ya faili zako. Unganisha, Bana, OCR na katalogi iliyobaki zinaweza kuitwa hivi.

Mwito hutuma nini kwa kweli

pdfx --api-base "$API_BASE" --api-key "$PDFX_API_KEY" \
  merge a.pdf b.pdf -o merged.pdf

--api-base huchukua https://pdf123.xyz kama chaguo-msingi, na --api-key (au kigezo cha mazingira PDFX_API_KEY) ni cha hiari, kwa hivyo katalogi ya bila jina hufanya kazi bila funguo. Elekeza msingi kwa http://127.0.0.1:8080 kwa mrundikano wako wa docker-compose. Hakuna itifaki ya pili chini ya hii: CLI ni mteja wa uso wa REST ulioelezwa kwenye Watengenezaji, na majina ya operesheni hulingana na zana za jukwaa na hati ya OpenAPI kwenye /v1/openapi.json.

Katalogi inaweza kugunduliwa bila kuondoka kwenye terminal. pdfx list huchapisha kila zana na pdfx describe add-stamp huchapisha sehemu na chaguo-msingi za zana moja, ambayo ni fafanuzi huo huo ambao jukwaa huonyesha kama fomu.

Uendeshaji wa makundi na vibendera ambavyo curl hukulazimisha kuandika mwenyewe

Ipe zana ya faili moja vipengele kadhaa vya kuingiza na itaviendesha kama kundi kwenye katalogi ya -o, ikichapisha mstari mmoja wa input -> saved kwa kila faili. Hitilafu huenda kwenye stderr na faili zilizobaki bado hukamilika, kwa hivyo PDF moja mbovu katika kundi la ankara haisitishi uendeshaji. --concurrency <n> huweka faili ngapi zinafanya kazi kwa wakati mmoja (chaguo-msingi 2).

-o huchukua faili au katalogi na haiandiki juu ya faili iliyopo, ikitumia jina la faili la seva ndani ya katalogi badala yake. Hilo ni muhimu seva inapoita tokeo kwa jina la kuingiza: bila hivyo, uendeshaji ungeandika juu ya PDF uliyomaliza kupakia.

Vipengele vilivyosimbwa hufunguliwa kabla ya ombi, si na zana: --input-password hushughulikia kila faili katika uendeshaji, na --password-for report.pdf=secret huweka funguo ya faili moja na inaweza kurudiwa, huku * ikiwakilisha zilizobaki. Kundi linalochanganya faili zilizofungwa na zilizo wazi kwa hivyo halihitaji kupangwa kwa mkono. --json huchapisha { path, contentType, bytes } kwa kila tokeo, au [{ input, ok, path | error, reason }] kwa kundi, ili kifuniko kiweze kuchanganua matokeo badala ya kuchambua mistari inayosomeka.

Misimbo ya kutoka ambayo hati ya maandishi inaweza kutumia

0 humaanisha mafanikio, 1 humaanisha ombi limeshindwa (katika kundi: angalau faili moja), 2 ni hitilafu ya matumizi ambapo hakuna kilichopakiwa, na 130 humaanisha ulisitisha na ombi lililokuwa likiendeshwa likatupwa. Hitilafu huchapisha mistari ya reason:, code: na hint: chini ya ujumbe inapopatikana, na ndiyo hati ya maandishi inapaswa kulinganisha, si maneno ya kawaida.

Kutoka moja ni rahisi kuelewa vibaya. Zana isiyopata chochote cha kurudisha hutoka kwa msimbo usio sifuri na code: no_content badala ya kuandika faili tupu, kwa hivyo pdf-to-csv kwenye PDF isiyo na majedwali ni kushindwa, si CSV ya baiti sifuri.

Baiti huenda wapi

Faili hupakiwa kwenye URL ya msingi, huchakatwa huko, na hufutwa mara jibu linapotumwa. Huo ni mkataba huo huo wa fomu ya kivinjari; CLI hubadilisha mteja, si mahali. Kwa hati zisizoruhusiwa kuondoka kwenye mtandao wako, endesha pdfx-server mwenyewe na uelekeze --api-base kwake, jambo linaloelezwa kwenye Kujipangisha.

Hakuna hali ya nje ya mtandao ya kurejea: kama msingi haupatikani, amri hushindwa. pdfx ni mteja wa mtandao ambaye kwa bahati ni mzuri kwenye shell, si injini ya PDF ya ndani.

Kile CLI isivyo

pdfx si GUI ya mezani wala maktaba ya OCR inayoweza kupachikwa unayoiunganisha kwenye programu nyingine. Ni mteja wa mstari wa amri kwa operesheni za PDF, kwa hivyo kazi moja ya mkono bado huhudumiwa vyema na jukwaa (Bana, OCR, na katalogi iliyobaki), na kitu chochote kinachohitaji mti wake wa UI kingeunda tena tatizo la kutofautiana linaloelezwa kwenye Operesheni moja, wateja wanne.

Ajenti hupata maumbo hayo hayo kutoka kwa ujuzi uliochapishwa kwenye /skills/pdf123.md, ambao unaeleza kwa ukamilifu maombi ya merge na pipeline. Kwa majaribio salama ya POST zinazobadilisha, tuma Idempotency-Key; CLI bado hufanya ombi moja kwa kila mwito, kwa hivyo kichwa hicho ni cha anayelirudia (Idempotency-Key: Majaribio Salama kwa Kazi za PDF). Funguo, vikomo vya maombi na misimbo ya hitilafu ziko kwenye Watengenezaji.

Open tool
Process in the browser β€” no watermark, files removed after the job.
Open tool