Chuyển đổi PDF sang Base64

Gửi PDF qua API JSON

JSON không có kiểu dữ liệu nhị phân, nên các REST API nhận tài liệu thường nhận chúng dưới dạng chuỗi Base64. Các nền tảng chữ ký điện tử, hệ thống lập hóa đơn và hóa đơn điện tử, dịch vụ in ấn và gửi thư, công cụ OCR và kho lưu trữ tài liệu thường nhận PDF theo cách này, trong một trường như content, file hoặc documentBase64, còn tên tệp nằm ở một trường riêng. Một số dịch vụ cũng trả về PDF theo cách tương tự; công cụ Base64 sang PDF sẽ chuyển chúng trở lại thành tệp.

Hãy gửi Base64 thuần không có dấu xuống dòng, trừ khi tài liệu API quy định khác, vì nhiều API từ chối giá trị vẫn còn tiền tố data:application/pdf;base64,. Cũng nên lưu ý giới hạn kích thước yêu cầu: một tệp PDF 7,5 MB sẽ thành khoảng 10 MB Base64.

Nhận biết PDF ở dạng Base64

Tệp PDF bắt đầu bằng các ký tự %PDF-, theo sau là số phiên bản. Khi mã hóa Base64, các byte này luôn tạo ra chuỗi bắt đầu bằng JVBERi0. Một chuỗi dài bắt đầu bằng JVBER trong phản hồi API, cột cơ sở dữ liệu hay tệp nhật ký gần như chắc chắn là một tệp PDF. Bạn cũng có thể kiểm tra như vậy trước khi gửi dữ liệu: nếu chuỗi của bạn bắt đầu bằng bất kỳ ký tự nào khác, có thể bạn đã mã hóa nhầm dữ liệu, hoặc đã mã hóa hai lần.

Nhúng PDF vào HTML

Data URI đặt toàn bộ tệp PDF bên trong trang HTML, không cần lưu trữ một tệp riêng:

<embed src="data:application/pdf;base64,JVBERi0..." type="application/pdf" width="100%" height="600">

<iframe src="data:application/pdf;base64,JVBERi0..." width="100%" height="600"></iframe>

Cách này hoạt động trên trình duyệt máy tính có trình xem PDF tích hợp, nhưng có những hạn chế. Nhiều trình duyệt di động hoàn toàn không hiển thị PDF bên trong trang. Chrome và một số trình duyệt khác cũng chặn trang điều hướng toàn bộ thẻ đến một URL data:, nên một liên kết hoặc lệnh gọi window.open trỏ tới URI data:application/pdf có thể mở ra thẻ trống hoặc không có tác dụng gì. Để mở PDF trong thẻ mới bằng JavaScript, hãy chuyển Base64 thành Blob URL. Với tài liệu lớn hơn vài megabyte, URL tệp thông thường thường là lựa chọn tốt hơn.

Mã hóa PDF bằng mã

# Python: tạo phần thân yêu cầu JSON
import base64, json
from pathlib import Path

pdf_b64 = base64.b64encode(Path('invoice.pdf').read_bytes()).decode('ascii')
body = json.dumps({'filename': 'invoice.pdf', 'content': pdf_b64})

// Trình duyệt: tệp lấy từ một <input type="file">
const reader = new FileReader();
reader.onload = () => {
  const pdfBase64 = reader.result.split(',')[1]; // bỏ tiền tố data URI
};
reader.readAsDataURL(file);