Cara mengirim PDF ke API sebagai Base64
API e-faktur, tanda tangan elektronik, atau pengiriman barang meminta dokumen di dalam kolom JSON. Begini cara mengubah PDF menjadi teks yang tepat, memeriksanya, dan menghindari kesalahan yang membuat permintaan gagal.
Oleh Metin Ersoy · Diperbarui 10 November 2026
Apa yang biasanya diminta API
Sebagian besar API dokumen menjelaskan body JSON dengan kolom bernama content, file, data, atau document. Isinya adalah kode Base64 dari PDF, sering kali disertai nama file dan jenisnya:
{
"fileName": "invoice-1024.pdf",
"mimeType": "application/pdf",
"content": "JVBERi0xLjcKJ..."
}
Sebelum menulis kode apa pun, cari tiga hal di dokumentasinya: nama kolom, apakah awalan data: diperlukan (biasanya tidak), dan batas ukurannya.
1. Ubah PDF ke Base64
Cara tercepat untuk mendapatkan nilai uji adalah PDF ke Base64. Pilih PDF, pilih Kode Base64 saja, lalu salin hasilnya. Jika Anda ingin titik awal berupa body permintaan yang lengkap, pilih JSON: opsi ini otomatis menambahkan nama file dan jenisnya. PDF diubah di browser Anda dan tidak diunggah, dan itu penting jika dokumen ujinya adalah faktur sungguhan.
Periksa hasilnya: kode harus diawali JVBERi0, tidak berisi spasi, dan selain satu atau dua tanda = di bagian akhir, hanya terdiri dari huruf, angka, + dan /.
2. Kirim dari kode Anda
Langkah yang sama dalam tiga bahasa yang umum. Masing-masing membaca file, mengubahnya ke Base64, lalu mengirim JSON-nya:
# curl (Linux / macOS): base64 -w 0 keeps it on one line
curl -X POST https://api.example.com/documents \
-H "Content-Type: application/json" \
-d "{\"fileName\":\"invoice.pdf\",\"content\":\"$(base64 -w 0 invoice.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('invoice.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ fileName: 'invoice.pdf', content }),
});
# Python 3 with requests
import base64, requests
with open("invoice.pdf", "rb") as f:
content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
json={"fileName": "invoice.pdf", "content": content})
Di macOS, baris curl memakai base64 -i invoice.pdf sebagai ganti -w 0. Alamat dan nama kolom di atas hanya contoh; gunakan yang tercantum di dokumentasi layanan Anda.
3. Pastikan dokumen kembali utuh
Jika layanan mengembalikan dokumen atau salinan yang disimpan dalam bentuk Base64, tempelkan jawaban itu ke Base64 ke PDF. Melihat halaman pertama dan jumlah halamannya adalah cara tercepat untuk memastikan tidak ada yang hilang di perjalanan. Langkah lengkap untuk arah sebaliknya ada di Cara menyimpan kode Base64 sebagai file PDF.
Kesalahan yang sering terjadi
| Gejala | Kemungkinan penyebab | Solusi |
|---|---|---|
| "Invalid Base64" | Ada baris baru (baris 76 karakter) atau awalan data: | Kirim kode polos dalam satu baris |
| "Payload too large" (413) | PDF terlalu besar setelah diubah ke Base64 | Perkecil dengan Kompres PDF |
| PDF terbuka kosong atau rusak | String-nya terpotong | Ubah lagi dan kirim seluruh nilainya |
| Nama dengan huruf beraksen tampil aneh | Nama file dikirim dengan encoding yang salah | Pastikan body JSON memakai UTF-8 |
Siap mencobanya? Gratis, dan file Anda tetap di perangkat Anda.
Buka PDF ke Base64