Kapan Anda perlu PDF dalam bentuk Base64?
JSON, XML dan banyak formulir hanya bisa membawa teks, jadi file biner seperti PDF harus ditulis sebagai teks terlebih dahulu. Base64 adalah cara yang umum dipakai:
- Mengirim dokumen ke API. Layanan e-faktur, tanda tangan elektronik, pengiriman barang dan manajemen dokumen sering meminta PDF di kolom bernama content, file atau data.
- Menguji integrasi Anda sendiri. Dengan opsi JSON, Anda langsung mendapat body permintaan yang siap ditempel ke Postman, curl atau unit test, tanpa menulis kode encoding apa pun.
- Menyimpan di kolom teks atau konfigurasi. Sebagian sistem menyimpan templat atau sertifikat kecil sebagai teks; Base64 membuat PDF bisa disimpan di sana.
- Menyematkan di halaman web. Data URI memungkinkan halaman menampilkan PDF di iframe tanpa meng-hosting file terpisah, cocok untuk dokumen kecil.
Contoh permintaan langkah demi langkah dengan curl, JavaScript dan Python ada di Cara mengirim PDF ke API sebagai Base64. Untuk mengubah kode kembali menjadi file, gunakan Base64 ke PDF; untuk gambar, lihat Gambar ke Base64.
Seperti apa tampilan setiap format
| Format | Diawali dengan | Penggunaan umum |
|---|---|---|
| Kode Base64 saja | JVBERi0 | Kolom API, JSON, XML, database |
| Data URI | data:application/pdf;base64, | Tab browser, iframe, tag object |
| Baris 76 karakter | JVBERi0, dipecah menjadi baris pendek | Lampiran email (MIME), file bergaya PEM |
| JSON | { "fileName": … } | Body permintaan untuk menguji integrasi |
Jika ada masalah
"File ini bukan PDF yang valid." File tidak diawali tanda %PDF-, mungkin itu file Word atau gambar yang namanya diubah menjadi .pdf. Buka dulu di pembaca PDF, atau konversi dengan alat yang sesuai.
API menyebut isinya tidak valid. Pastikan Anda mengirim kode polos tanpa awalan data: dan tanpa jeda baris, kecuali dokumentasinya memintanya. Pastikan juga tidak ada bagian akhir yang terpotong saat Anda menempelkannya.
Teksnya terlalu panjang untuk kolom. Perkecil PDF dengan Kompres PDF lalu ubah lagi; kodenya akan menyusut dengan proporsi yang sama.