여러 PDF 파일을 하나의 PDF로 병합하는 방법
두 개 이상의 PDF를 Base64 파일 값으로 준비해 원하는 순서의 목록으로 전달하면 하나의 PDF로 결합할 수 있습니다. 성공 결과에는 결합 PDF의 Base64 값과 처리된 페이지 수, 결합된 파일 수가 함께 포함됩니다.
결합 전에 입력을 준비하는 기준
PDF 여러 개를 하나의 문서로 모아야 한다면 PDF Merger로 결합할 수 있습니다. 이 기능은 제공된 PDF 파일 값을 읽어 한 문서로 합치는 방식입니다. 입력에는 사용할 PDF를 두 개 이상 포함해야 하며, 각 값은 Base64로 인코딩된 파일 값이어야 합니다. 결합할 순서를 미리 정하면 결과를 확인하기가 수월합니다. 목록에 적은 파일의 순서가 결과에 반영되고, 각 PDF 안에 있는 페이지도 원래 순서대로 이어집니다. 따라서 본문, 별첨, 참고 자료처럼 문서의 흐름을 정한 뒤 목록을 구성하세요. 결합이 성공하면 하나의 PDF를 나타내는 Base64 값이 반환됩니다. 처리된 페이지 수와 결합된 파일 수도 함께 제공되므로, 결과가 예상한 입력과 맞는지 점검할 수 있습니다. 이 기능은 여러 PDF를 한 문서로 모으는 작업에 맞으며, 입력 순서를 관리하는 것이 핵심입니다.
파일 목록을 정하고 결합 실행하기
- 결합할 PDF를 두 개 이상 선택합니다. 파일마다 내용을 읽을 수 있는 PDF인지 확인한 다음, 각 파일을 Base64로 인코딩한 파일 값으로 준비하세요. 파일 값이 PDF를 나타내도록 준비되어야 다음 처리 단계에서 PDF로 읽을 수 있습니다.
- 준비한 값을 파일 목록에 추가합니다. 목록의 첫 번째 위치에는 결과에서 먼저 나오게 할 PDF를 놓고, 뒤에 이어질 자료를 차례로 배치하세요. 한 PDF 안의 페이지 순서를 바꾸지 않으므로, 파일 순서와 각 파일의 내부 페이지 순서를 함께 확인하는 편이 좋습니다.
- 파일 목록이 비어 있지 않은지, 사용할 수 있는 값이 두 개 이상인지 점검한 뒤 결합을 실행합니다. 사용 가능한 목록을 전달하지 않거나 파일 수가 두 개보다 적으면 성공하지 않습니다. 실행 전에 목록에서 빠진 값이나 잘못된 위치가 없는지도 살펴보세요.
- 처리가 끝나면 성공 또는 실패 결과를 확인합니다. 성공한 경우 반환된 결합 PDF의 Base64 값을 결과로 사용하고, 함께 제공된 페이지 수와 파일 수를 입력과 비교하세요. PDF를 읽는 과정에서 문제가 생기거나 처리 중 예외가 발생하면 실패가 보고될 수 있으므로, 실패한 상태에서는 결과 PDF 값이 성공적으로 만들어졌다고 간주하지 마세요.
성공 결과와 실패 상태를 읽는 방법
성공 결과에서 결합 PDF의 Base64 값은 여러 입력을 하나로 묶은 문서를 나타냅니다. 이 값을 확인할 때는 페이지 수와 파일 수를 함께 살펴보세요. 파일 수는 결합 대상으로 전달한 PDF의 개수와 비교할 수 있고, 페이지 수는 입력 PDF 페이지가 어떤 규모로 합쳐졌는지 점검하는 기준이 됩니다. 목록에 세 파일을 넣었다면 파일 수가 입력한 세 파일과 맞는지 확인하는 식입니다. 페이지 순서가 중요하다면 첫 파일의 마지막 페이지 다음에 두 번째 파일의 첫 페이지가 이어지는지 확인하세요. 결과가 실패라면 먼저 사용 가능한 파일이 두 개 이상인지 확인하고, 각 값이 Base64로 준비된 PDF를 가리키는지 다시 점검합니다. 그 뒤에도 처리되지 않으면 PDF를 읽는 과정이나 처리 중 예외가 원인일 수 있습니다. 이때는 실패 결과를 성공 문서로 사용하지 말고 입력 값을 정리해 다시 시도하세요. 이 기능의 결과는 PDF 결합에 관한 것이므로, 반환된 수치만으로 페이지 내용의 변경 여부를 판단하지는 마세요.
사용 예시
회의 본문 뒤에 부록이 이어지는 한 문서를 만들기 위해 두 PDF의 순서를 정해 결합하려는 상황입니다.
회의 자료 PDF와 부록 PDF를 각각 Base64 파일 값으로 준비한 뒤 회의 자료를 첫 번째 위치에, 부록을 두 번째 위치에 배치하고 결합을 실행합니다.
성공하면 결합 PDF의 Base64 값과 처리된 페이지 수, 결합된 파일 수가 포함된 결과를 확인할 수 있습니다.
제한 사항
- 사용 가능한 PDF가 두 개보다 적거나 파일 값을 PDF로 읽지 못하거나 처리 중 예외가 발생하면 결합에 성공하지 않습니다.
자주 발생하는 오류
- 파일 목록에 사용할 수 있는 PDF가 한 개만 있거나 목록을 전달하지 않으면 결합이 실패할 수 있습니다. 두 개 이상의 PDF를 Base64 파일 값으로 준비해 목록에 넣고, 각 값이 PDF로 읽힐 수 있는지 확인한 뒤 다시 실행하세요.
자주 묻는 질문
PDF 파일 하나만으로도 결합할 수 있나요?
두 개 미만의 사용 가능한 파일을 전달하면 성공하지 않습니다. PDF를 두 개 이상 Base64 파일 값으로 준비해 목록에 포함해야 결합을 실행할 수 있습니다.
결합된 PDF의 페이지 순서는 어떻게 정해지나요?
결과의 파일 순서는 입력 목록에 적은 순서로 정해집니다. 각 파일 내부의 페이지도 제공된 PDF 안의 순서대로 추가되므로, 목록을 실행 전에 원하는 문서 흐름에 맞게 배열하세요.
결합이 끝나면 무엇을 받을 수 있나요?
처리가 성공하면 결합된 PDF를 나타내는 Base64 값이 반환됩니다. 처리된 페이지 수와 결합된 파일 수도 함께 제공되므로 입력 목록과 결과의 규모를 비교할 수 있습니다.