PDF 멀티 도구
명시적인 페이지 계획으로 PDF를 조립합니다: 페이지를 재정렬, 복제, 회전 또는 삭제하고, 추가 PDF에서 페이지를 가져와 한 번의 요청으로 모두 처리합니다.
API 엔드포인트
POST /api/v1/tools/pdf/multi-tool-pdf
하나 이상의 PDF 파일과 JSON settings 필드가 포함된 multipart form data를 받습니다. 요청당 최대 20개의 입력 문서와 1,200개의 출력 페이지를 지원합니다.
매개변수
| Parameter | Type | Required | Description |
|---|---|---|---|
| items | array | Yes | 출력 순서대로 정리한 페이지 계획입니다. 각 항목은 { "doc": <int>, "page": <int>, "rot": <90|180|270, optional> }입니다. doc는 업로드 순서대로 입력 파일을 가리키는 0부터 시작하는 인덱스이고, page는 해당 문서에서 1부터 시작하는 페이지 번호입니다. |
| pageCounts | array | Yes | 각 업로드 문서의 실제 페이지 수를 같은 순서로 나열합니다. 문서의 페이지 수를 초과하는 계획 페이지는 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 이미지에 포함되어 있습니다.
