ProductDakika 3 za kusoma

Operesheni Moja, Wateja Wanne: Kivinjari, curl, MCP, pdfx

Muunganisho huo wa PDF123 kupitia wateja wanne: fomu ya kivinjari, curl kwa /api/v1/general/merge-pdfs, MCP kwenye /mcp, na pdfx CLI dhidi ya API base yako.

By the PDF123 team · Updated 2026-09-29
Operesheni Moja, Wateja Wanne: Kivinjari, curl, MCP, pdfx

Wateja wanne huonekana kama bidhaa nne. Hushiriki katalogi moja. Chukua Unganisha kama kazi halisi: unganisha PDF kwa mpangilio wa upakiaji bila kubadilisha kurasa kuwa picha. Mfumo huo huo unashikilia kila zana nyingine ya katalogi (bana, OCR, badilisha muundo na zingine): kitambulisho kimoja cha operesheni, njia nne za kuiita.

Kivinjari

Fungua /merge, ongeza faili kwa mpangilio unaotaka, Process, pakua. Hakuna akaunti kwa zana za katalogi. Sehemu ya “Call this from code” ya ukurasa hujenga curl kutoka sehemu zile zile ambazo fomu hutuma, hivyo kiolesura na mkataba wa HTTP hubaki vikilingana.

Sehemu hiyo si maandishi ya matangazo. Imetengenezwa kutoka kwa ufafanuzi wa zana ambao jukwaa linatumia tayari kwa fomu, ndiyo sababu kubadilisha jina la kigezo huonekana mahali pote pamoja. Kama fomu inapokea sortType=byFileName ya hiari, mfano wa curl unaweza kubeba sehemu hiyo hiyo.

curl / REST

curl -fsS -X POST "$API_BASE/api/v1/general/merge-pdfs" \
  -F "[email protected]" \
  -F "[email protected]" \
  -o merged.pdf

Simu za katalogi bila jina hazihitaji funguo. Funguo kutoka Watengenezaji hupa uendeshaji wa kiotomatiki utambulisho thabiti (na seva zilizojipangisha lango). OpenAPI iko kwenye /v1/openapi.json.

Kwa kazi za hatua nyingi, POST /api/v1/pipeline hupokea operesheni zilizopangwa katika sehemu ya steps (kwa mfano merge, kisha muhuri wa maji, kisha kubana). Tuma Idempotency-Key wakati majaribio ya pili hayapaswi kuendesha kazi mara mbili; mwitikio uliorudiwa uliofanikiwa unaweza kurudi na Idempotency-Replayed. Kushindwa hutumia application/problem+json yenye misimbo thabiti kama rate_limited na bad_request (Hitilafu za Watengenezaji).

Majibu yaliyopangishwa pia hutangaza X-RateLimit-Limit, X-RateLimit-Remaining na X-RateLimit-Reset; HTTP 429 hujumuisha Retry-After. Chukua vichwa hivyo kama bajeti hai, si namba iliyokaririwa kutoka kwa blogu (kikomo cha maombi bila jina).

MCP

Ajenti wanaozungumza Model Context Protocol huunganisha kwenye /mcp, hugundua merge kama zana, na kuiita kwa hadithi hiyo hiyo ya funguo ya API kama REST. Nyaraka: MCP ya Watengenezaji.

MCP si katalogi ya pili. Ni itifaki ya ugunduzi na uitaji juu ya operesheni hizo hizo ambazo OpenAPI huorodhesha. Kama operesheni haipo kwenye MCP, hilo ni hitilafu ya seva, si ramani tofauti ya bidhaa. Unganisha MCP na /llms.txt unapotaka faharasa ya maandishi ya zana kabla mteja kuunganisha.

pdfx CLI

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

Umbo hilo hilo la multipart kama curl hapo juu, huku API base ikichukua ya iliyopangishwa kama chaguo-msingi. Kinachoongezwa na CLI ni urahisi wa shell: -o huchukua katalogi na haiandiki juu ya faili iliyopo, vipengele kadhaa hukimbia kama kundi kwa --concurrency, na kundi huripoti mstari mmoja wa input -> saved kwa kila faili huku hitilafu zikiwa kwenye stderr na zilizobaki zikikamilika. pdfx list na pdfx describe <tool> husoma katalogi inayoonyeshwa na jukwaa, na ujuzi uliochapishwa kwenye /skills/pdf123.md unaeleza maumbo hayo hayo ya merge na pipeline ili ajenti wasivumbue OpenAPI ya pili.

OCR kupitia yeyote wa wateja hawa bado hurudisha Markdown kutoka /api/v1/misc/ocr-pdf, si tabaka la maandishi lililofichwa. Ukweli huo ni sehemu ya mkataba unaoshirikiwa: kubadilisha aina ya kurudisha kwenye mteja mmoja bila wengine kungevunja ahadi ya “operesheni moja.” Kubana hubaki kwenye /api/v1/misc/compress-pdf kwa ubanaji upya wa mitiririko; ni operesheni tofauti na merge, inayofikiwa kwa njia hizo hizo nne.

Kwa nini usawa ni muhimu

Kama merge ya kivinjari na merge ya API zingetofautiana, uendeshaji wa kiotomatiki ungerudi nyuma kimya kimya wakati ukurasa wa maonyesho bado unaonekana mzuri. Operesheni moja, vishikio vinne, ndilo lengo. Jukwaa ni mteja wa urahisi, si utekelezaji wa pili wa merge, compress au OCR.

Ndiyo sababu pia hakuna tawi la mezani: mti wa tano wa kiolesura ungerejea tatizo la kutofautiana chini ya jina lingine la program. Muafaka mpana: Imejengwa kwa ajenti wa AI, si vivinjari pekee. Kwa uamuzi wa mezani, ona Kwa nini tuliruka programu ya mezani. Kwa kusimamisha API kwenye mtandao wako, ona Kujipangisha.

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