본문으로 건너뛰기

다음 도구 찾기

문서/API/PDF API: 병합, 분할, 회전, 압축
API

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입력추가 필드
mergesourceKeys: PDF 2개 이상, 순서대로—
splitsourceKeypages: 0부터 시작하는 배열. 예: [0, 1, 4]는 1, 2, 5페이지를 남깁니다
rotatesourceKeydegrees: 90, 180, 270 중 하나
compresssourceKey—(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부터 시작하는 번호를 사용합니다.

정확한 크기로 압축할 수 있습니까?

이 엔드포인트로는 할 수 없습니다. 균형을 맞춘 프로필 하나만 적용됩니다. 정확한 목표 크기가 필요하면 웹사이트의 크기 지정 압축 도구를 사용하십시오.

관련 가이드