Base64 PDF는 어디에서 오나요?
Base64는 영문자, 숫자, 몇 가지 기호만으로 어떤 파일이든 적을 수 있어 텍스트 안에 담아 보낼 수 있습니다. 그래서 PDF가 파일이 아니라 긴 문자열로 오는 경우가 많습니다.
- API 응답. 전자 청구서, 배송 라벨, 결제 영수증, 전자 서명 서비스는 보통 JSON이나 XML 안의 Base64 필드로 PDF를 돌려줍니다.
- 웹 양식과 데이터베이스. 일부 시스템은 업로드된 문서를 텍스트 열에 저장하므로, 내보내기를 하면 파일이 아니라 코드가 나옵니다.
- 이메일 원본. 이메일 원본을 보면 첨부 파일이 Content-Transfer-Encoding: base64 헤더 아래에 Base64 덩어리로 들어 있습니다.
- 개발 테스트. 내 코드가 Base64 PDF를 만들 때, 결과가 예상한 문서인지 빠르게 확인할 수 있습니다.
코드를 어디에서 찾고 어떻게 빠짐없이 복사하는지는 Base64 문자열을 PDF 파일로 저장하는 방법에서 단계별로 설명합니다. 이미지라면 Base64를 이미지로 변환을 참고하세요. 반대로 PDF의 코드를 얻으려면 PDF를 Base64로 변환을 사용하세요.
내용물 알아보는 법
| 코드 시작 부분 | 내용 | 사용할 도구 |
|---|---|---|
| JVBERi0 | PDF 문서 | 이 페이지 |
| data:application/pdf;base64, | PDF 문서(데이터 URI) | 이 페이지 |
| iVBORw0KGgo | PNG 이미지 | Base64를 이미지로 변환 |
| /9j/ | JPG 사진 | Base64를 이미지로 변환 |
| UEsDB | ZIP, 워드(.docx), 엑셀(.xlsx) | PDF 아님 |
문제가 생겼을 때
“올바른 Base64 코드가 아닙니다.” 코드에 다른 텍스트가 섞였거나 복사가 중간에 끊겼습니다. 따옴표 사이의 값 전체를 선택해 다시 붙여 넣으세요.
“내용이 PDF가 아닙니다”라고 나와요. 옆에 있는 다른 필드(파일 이름, ID, 서명 해시)를 복사했을 가능성이 큽니다. JVBERi0으로 시작하는 값을 찾으세요.
PDF는 열리는데 일부 페이지가 비어 있어요. 코드 끝부분이 빠진 경우입니다. 앞쪽 페이지는 디코딩되었지만 나머지는 코드에 들어 있지 않았던 것입니다. 코드를 처음부터 끝까지 다시 복사하세요. 긴 JSON 파일에서는 손으로 선택하는 것보다 뷰어의 “값 복사” 기능을 쓰는 편이 안전합니다.
PDF에서 암호를 요구해요. 인코딩되기 전에 이미 암호가 걸린 문서입니다. 암호를 알고 있다면 PDF 암호 해제로 암호를 없앨 수 있습니다.