PDF API: 병합, 분할, 회전, 압축
엔드포인트 하나로 여러 PDF 병합, 페이지 추출, PDF 회전 및 압축을 클라우드에서 처리합니다.
핵심 답변
operation에 merge, split, rotate, compress 중 하나를 지정해 POST /api/v1/pdf-job/ 요청을 보냅니다. merge에는 sourceKeys(순서대로)를, 나머지에는 sourceKey 하나를 전달합니다. split은 "pages"에 0부터 시작하는 페이지 번호를 받고, rotate는 "degrees"에 90, 180, 270 중 하나를 받습니다. 파일은 직접 업로드로 가져오며, 결과는 다른 작업과 똑같이 폴링하는 새 PDF 작업입니다.
operation 종류
파일은 이미 계정 스토리지에 있어야 합니다. 먼저 업로드한 뒤 반환된 objectKey 값을 사용하십시오.
| operation | 입력 | 추가 필드 |
|---|---|---|
| merge | sourceKeys: PDF 2개 이상, 순서대로 | — |
| split | sourceKey | pages: 0부터 시작하는 배열. 예: [0, 1, 4]는 1, 2, 5페이지를 남깁니다 |
| rotate | sourceKey | degrees: 90, 180, 270 중 하나 |
| compress | sourceKey | —(Ghostscript "ebook" 프로필, 이미지 150 dpi) |
업로드한 PDF 두 개 병합하기
이미 온라인에 있는 PDF를 병합하려면 PDF URL 2–20개를 순서대로 담은 "files" 배열과 함께 POST /api/v1/merge/를 보내십시오. 1크레딧이 들며 작업 대신 병합된 PDF를 응답으로 바로 반환하므로 노코드 도구에서 편리합니다.
curl -X POST 'https://maxscanner.app/api/v1/pdf-job/' \
-H "Authorization: Bearer $MAXSCANNER_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: pack-8812-merge' \
-d '{ "operation": "merge", "filename": "pack.pdf", "sourceKeys": ["users/<id>/media/inbox/…-cover.pdf", "users/<id>/media/inbox/…-contract.pdf"] }'한도 및 동작
각 입력은 최대 100 MB, 작업 하나의 합계는 최대 150 MB입니다. 압축은 이미지를 약 150 dpi로 다시 기록하므로 이메일과 업로드에 적합합니다. 원래 작은 텍스트 PDF는 크게 줄어들지 않을 수 있습니다. 암호화된 PDF는 먼저 잠금을 해제해야 합니다.
자주 묻는 질문
페이지 번호는 0부터 시작합니까?
API에서는 그렇습니다. [0]이 첫 페이지입니다. 웹사이트 도구는 1부터 시작하는 번호를 사용합니다.
정확한 크기로 압축할 수 있습니까?
이 엔드포인트로는 할 수 없습니다. 균형을 맞춘 프로필 하나만 적용됩니다. 정확한 목표 크기가 필요하면 웹사이트의 크기 지정 압축 도구를 사용하십시오.