Base64를 PDF로, 문서를 어디에도 보내지 않고.

JSON은 원시 바이트를 담을 수 없기 때문에 전자 서명, 청구서 발행, 급여, 배송 라벨, 리포트처럼 문서를 반환하는 API는 대개 PDF를 Base64로 바꿔 문자열 필드에 넣습니다. 이메일도 마찬가지로 PDF 첨부 파일이 MIME 원본 안에서 76자마다 줄이 바뀐 Base64로 전달됩니다. 둘 다 여기서 그대로 디코딩할 수 있으며, 줄바꿈을 미리 지울 필요가 없습니다.

모든 PDF는 %PDF-로 시작하고, Base64에서는 항상 JVBERi0이 됩니다. 문자열이 이 일곱 글자로 시작하면 PDF입니다. 다른 접두사로는 대신 무엇이 들어 있는지 알 수 있습니다:

UEsDB는 ZIP 컨테이너를 뜻하며, Word와 Excel 파일도 이 형식입니다. H4sI는 문서가 인코딩 전에 gzip으로 압축되었다는 뜻입니다. 결과를 .gz 파일로 다운로드해 압축을 풀면 PDF가 나옵니다.

• 원시 JSON에서 복사했습니다. JSON은 슬래시를 \/로 이스케이프할 수 있습니다. 파싱된 화면에서 값을 복사하거나 \/를 /로 바꾸세요. 백슬래시는 올바른 Base64가 아닙니다.
• 잘렸습니다. 완전한 PDF는 %%EOF로 끝납니다. 16진수 탭에서 문서가 그 전에 끝난다면 Base64가 잘린 것이고, PDF 리더는 파일이 손상되었다고 표시합니다.
• 두 번 인코딩되었습니다. 결과가 텍스트로 JVBERi0로 시작한다면 Base64로 두 번 인코딩된 것입니다. 입력으로 보내기를 누르고 다시 디코딩하세요.
• 암호로 보호되어 있습니다. 디코딩은 파일을 그대로 복원할 뿐이므로, 암호화된 파일이었다면 PDF 리더가 계속 암호를 요구합니다.

# Python
import base64
with open("document.pdf", "wb") as f:
    f.write(base64.b64decode(response["pdf"]))

// Node.js
fs.writeFileSync("document.pdf", Buffer.from(json.pdf, "base64"));

# Shell, straight from an API response
curl -s https://api.example.com/invoice/42 | jq -r .pdf | base64 --decode > invoice.pdf

Java, C#, PHP, Go, PowerShell 예제는 Base64 디코딩 코드 예제에서 확인하세요.