PDFVela — pdfvela.com
Semua alat PDF

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 · 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

GejalaKemungkinan penyebabSolusi
"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 Base64Perkecil dengan Kompres PDF
PDF terbuka kosong atau rusakString-nya terpotongUbah lagi dan kirim seluruh nilainya
Nama dengan huruf beraksen tampil anehNama file dikirim dengan encoding yang salahPastikan body JSON memakai UTF-8

Siap mencobanya? Gratis, dan file Anda tetap di perangkat Anda.

Buka PDF ke Base64

Pertanyaan seputar mengirim PDF sebagai Base64

Mengapa API meminta Base64, bukan filenya langsung?

JSON hanya bisa membawa teks. Base64 menuliskan byte PDF dengan huruf, angka, + dan /, sehingga seluruh dokumen muat dalam satu kolom string bersama data lain, misalnya nomor pelanggan atau tanggal faktur.

Apakah awalan data:application/pdf;base64, perlu ikut dikirim?

Biasanya tidak. Kebanyakan API hanya meminta kodenya, yang diawali JVBERi0. Kirim data URI hanya jika dokumentasi menunjukkannya, atau jika browser membutuhkan URL, misalnya di dalam iframe.

API menyebut Base64 saya tidak valid. Apa penyebab yang paling sering?

Ada baris baru atau awalan di dalam string, atau kodenya terpotong saat ditempel. Pakai kode polos dalam satu baris dan pastikan ujung string terkirim utuh.

Seberapa besar PDF yang bisa dikirim?

Itu tergantung layanannya, tetapi teks Base64 sekitar sepertiga lebih besar daripada filenya, jadi PDF 3 MB menjadi sekitar 4 MB JSON. Banyak API berhenti di beberapa megabyte; mengompres PDF terlebih dahulu adalah solusi paling mudah.

Apakah Base64 termasuk enkripsi?

Bukan. Siapa pun yang memegang kodenya bisa mengubahnya kembali menjadi dokumen. Kirim hanya lewat HTTPS dan jangan pernah menempelkan PDF rahasia ke situs yang mengunggahnya.