Khi nào bạn cần PDF ở dạng Base64?
JSON, XML và nhiều biểu mẫu chỉ chứa được văn bản, nên một tệp nhị phân như PDF phải được viết lại thành văn bản trước. Base64 là cách làm phổ biến nhất:
- Gửi tài liệu tới một API. Các dịch vụ hóa đơn điện tử, ký điện tử, vận chuyển và quản lý tài liệu thường yêu cầu PDF nằm trong một trường tên là content, file hoặc data.
- Thử nghiệm tích hợp của riêng bạn. Với tùy chọn JSON, bạn có sẵn phần thân yêu cầu để dán vào Postman, curl hoặc unit test mà không phải tự viết đoạn mã nào để mã hóa.
- Lưu vào cột văn bản hoặc tệp cấu hình. Một số hệ thống lưu mẫu tài liệu hay chứng chỉ nhỏ dưới dạng văn bản; Base64 giúp PDF vừa với chỗ đó.
- Nhúng vào trang web. Data URI cho phép trang web hiển thị PDF trong iframe mà không cần lưu tệp riêng, phù hợp với tài liệu nhỏ.
Ví dụ yêu cầu từng bước bằng curl, JavaScript và Python có trong Cách gửi PDF tới API dưới dạng Base64. Để chuyển mã ngược lại thành tệp, dùng Base64 sang PDF; với ảnh, xem Ảnh sang Base64.
Mỗi định dạng trông như thế nào
| Định dạng | Bắt đầu bằng | Thường dùng cho |
|---|---|---|
| Chỉ mã Base64 | JVBERi0 | Trường API, JSON, XML, cơ sở dữ liệu |
| Data URI | data:application/pdf;base64, | Thẻ trình duyệt, iframe, thẻ object |
| Dòng 76 ký tự | JVBERi0, được ngắt thành các dòng ngắn | Tệp đính kèm email (MIME), tệp kiểu PEM |
| JSON | { "fileName": … } | Phần thân yêu cầu để thử nghiệm tích hợp |
Nếu gặp sự cố
"Tệp này không phải là PDF hợp lệ." Tệp không bắt đầu bằng chữ ký %PDF-, có thể đó là tệp Word hoặc ảnh bị đổi tên thành .pdf. Hãy mở thử bằng trình đọc PDF trước, hoặc chuyển đổi bằng công cụ phù hợp.
API báo nội dung không hợp lệ. Kiểm tra xem bạn đã gửi mã thuần, không có tiền tố data: và không có dấu xuống dòng, trừ khi tài liệu API yêu cầu. Cũng hãy chắc chắn phần cuối không bị cắt mất khi dán.
Văn bản quá dài so với trường. Hãy giảm dung lượng PDF bằng Nén PDF rồi chuyển lại; mã sẽ ngắn đi theo đúng tỷ lệ đó.