PDF를 Base64로 바꿔야 하는 경우
JSON, XML과 많은 양식은 텍스트만 담을 수 있어서, PDF 같은 바이너리 파일은 먼저 텍스트로 바꿔야 합니다. 이때 가장 흔히 쓰는 방법이 Base64입니다.
- API로 문서 보내기. 전자 세금계산서, 전자 서명, 배송, 문서 관리 서비스는 content, file, data 같은 이름의 필드에 PDF를 넣어 달라고 하는 경우가 많습니다.
- 직접 만든 연동 기능 테스트. JSON 형식을 고르면 인코딩 코드를 직접 짜지 않아도 Postman, curl, 단위 테스트에 바로 붙여 넣을 수 있는 요청 본문이 만들어집니다.
- 텍스트 열이나 설정에 저장. 작은 템플릿이나 인증서를 텍스트로 보관하는 시스템이 있습니다. Base64를 쓰면 PDF도 그런 곳에 넣을 수 있습니다.
- 웹페이지에 넣기. Data URI를 쓰면 파일을 따로 올리지 않고도 페이지의 iframe에 PDF를 표시할 수 있습니다. 작은 문서에 알맞습니다.
curl, JavaScript, Python으로 요청을 보내는 단계별 예시는 PDF를 Base64로 API에 보내는 방법에 있습니다. 코드를 다시 파일로 되돌리려면 Base64를 PDF로 변환을, 사진은 이미지를 Base64로 변환을 사용하세요.
형식별 모양
| 형식 | 시작 부분 | 주요 용도 |
|---|---|---|
| Base64 코드만 | JVBERi0 | API 필드, JSON, XML, 데이터베이스 |
| Data URI | data:application/pdf;base64, | 브라우저 탭, iframe, object 태그 |
| 76자 줄바꿈 | JVBERi0, 짧은 줄로 나뉨 | 이메일 첨부(MIME), PEM 형식 파일 |
| JSON | { "fileName": … } | 연동 기능 테스트용 요청 본문 |
문제가 생겼을 때
“올바른 PDF 파일이 아닙니다”라는 메시지가 나옵니다. 파일이 %PDF- 서명으로 시작하지 않는 경우입니다. 이름만 .pdf로 바꾼 워드 파일이나 이미지일 수 있습니다. 먼저 PDF 뷰어에서 열어 보거나, 알맞은 도구로 변환하세요.
API가 내용이 올바르지 않다고 합니다. 문서에서 따로 요구하지 않는 한, data: 접두어와 줄바꿈 없이 코드만 보냈는지 확인하세요. 붙여 넣을 때 끝부분이 잘리지 않았는지도 확인하세요.
텍스트가 입력란에 들어가기에 너무 깁니다. PDF 압축으로 PDF 용량을 줄인 뒤 다시 변환하세요. 코드도 같은 비율로 짧아집니다.