此頁面為機器翻譯。發現錯誤了嗎?協助我們改善。
Skip to content

PDF 多功能工具 ​

透過明確的頁面計劃組合 PDF:重新排序、複製、旋轉或刪除頁面,並從其他 PDF 拉取頁面,所有操作皆在單一請求中完成。

API 端點 ​

POST /api/v1/tools/pdf/multi-tool-pdf

接受包含一個或多個 PDF 檔案及一個 JSON settings 欄位的 multipart 表單資料。 每個請求最多支援 20 個輸入文件與 1,200 個輸出頁面。

參數 ​

參數類型必填描述
itemsarray是按輸出順序排列的輸出頁面計劃。每個項目為 { "doc": <int>, "page": <int>, "rot": <90|180|270, optional> }。doc 以上傳順序索引上傳的檔案(從 0 開始);page 是該文件中以 1 為基準的頁碼。
pageCountsarray是每個上傳文件的實際頁數,順序相同。計劃中的頁面超出其文件頁數時,會以 400 拒絕。

請求範例 ​

取第一份文件的第 3 頁與第 1 頁,再取第二份文件的第 1 頁與第 2 頁,將第一個輸出頁面旋轉 90° 順時針:

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]}'

回應範例 ​

json
{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document_multi-tool.pdf",
  "originalSize": 2450000,
  "processedSize": 2450000
}

注意事項 ​

  • 同一頁面可以在 items 中出現多次以複製它。
  • 未出現在 items 中的頁面將從輸出中省略。
  • rot 記錄複製頁面上的新顯示方向(與任何現有旋轉組合);頁面內容不會被修改。
  • 旋轉按每個輸出副本套用,因此副本可以有不同的旋轉。
  • 輸出為新的扁平文件;來源書籤與文件層級的中繼資料不會保留。
  • 處理需要 qpdf 二進位檔案,該檔案包含在官方 Docker 映像中。