PDF Multi-Tool
Bygg ihop en PDF från en explicit sidplan: ordna om, duplicera, rotera eller ta bort sidor, och hämta in sidor från ytterligare PDF-filer – allt i en begäran.
API-endpunkt
POST /api/v1/tools/pdf/multi-tool-pdf
Accepterar multipart-formulärdata med en eller flera PDF-filer och ett JSON-fält settings. Upp till 20 indokument och 1 200 utgångssidor stöds per begäran.
Parametrar
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| items | array | Ja | Utgångssidplan i utgångsordning. Varje objekt är { "doc": <int>, "page": <int>, "rot": <90|180|270, optional> }. doc indexerar de uppladdade filerna i uppladdningsordning (0-baserat); page är ett 1-baserat sidnummer i det dokumentet. |
| pageCounts | array | Ja | Verkligt sidantal för varje uppladdat dokument i samma ordning. En plansida utöver dokumentets sidantal avvisas med 400. |
Exempelbegäran
Ta sidorna 3 och 1 från det första dokumentet, sedan sidorna 1 och 2 från det andra, och rotera den första utgångssidan 90° medurs:
bash
curl -X POST http://localhost:1349/api/v1/tools/pdf/multi-tool-pdf \
-H "Authorization: Bearer si_your-api-key" \
-F "[email protected]" \
-F "[email protected]" \
-F 'settings={"items":[{"doc":0,"page":3,"rot":90},{"doc":0,"page":1},{"doc":1,"page":1},{"doc":1,"page":2}],"pageCounts":[3,2]}'Exempelsvar
json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document_multi-tool.pdf",
"originalSize": 2450000,
"processedSize": 2450000
}Anteckningar
- Samma sida kan förekomma flera gånger i
itemsför att duplicera den. - Sidor som saknas i
itemsutelämnas från utdata. rotregistrerar den nya visningsorienteringen på den kopierade sidan (sammansatt med eventuell befintlig rotation); sidinnehållet påverkas inte.- Rotation tillämpas per utgångskopia, så duplicat kan ha olika rotationer.
- Utdata är ett nytt, platt dokument; källbokmärken och dokumentnivåmetadata bevaras inte.
- Bearbetning kräver qpdf-binären, som ingår i den officiella Docker-avbildningen.
