이 페이지는 기계 번역되었습니다. 잘못된 부분을 발견하셨나요?개선을 도와주세요.
Skip to content

PDF 멀티 도구 ​

명시적인 페이지 계획으로 PDF를 조립합니다: 페이지를 재정렬, 복제, 회전 또는 삭제하고, 추가 PDF에서 페이지를 가져와 한 번의 요청으로 모두 처리합니다.

API 엔드포인트 ​

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

하나 이상의 PDF 파일과 JSON settings 필드가 포함된 multipart form data를 받습니다. 요청당 최대 20개의 입력 문서와 1,200개의 출력 페이지를 지원합니다.

매개변수 ​

ParameterTypeRequiredDescription
itemsarrayYes출력 순서대로 정리한 페이지 계획입니다. 각 항목은 { "doc": <int>, "page": <int>, "rot": <90|180|270, optional> }입니다. doc는 업로드 순서대로 입력 파일을 가리키는 0부터 시작하는 인덱스이고, page는 해당 문서에서 1부터 시작하는 페이지 번호입니다.
pageCountsarrayYes각 업로드 문서의 실제 페이지 수를 같은 순서로 나열합니다. 문서의 페이지 수를 초과하는 계획 페이지는 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 이미지에 포함되어 있습니다.