PDF'den Base64'e Dönüştürücü

PDF'leri JSON API'leri üzerinden gönderme

JSON'da ikili veri türü yoktur; bu nedenle belge alan REST API'leri belgeleri genellikle Base64 dizesi olarak kabul eder. E-imza platformları, faturalama ve e-fatura sistemleri, baskı ve posta hizmetleri, OCR motorları ve belge arşivleri PDF'leri çoğunlukla bu şekilde, content, file veya documentBase64 gibi bir alanda ve dosya adını ayrı bir alanda alır. Bazı hizmetler PDF'leri de aynı şekilde döndürür; Base64'ten PDF'ye aracı bunları yeniden dosyaya dönüştürür.

API belgeleri aksini belirtmedikçe ham Base64'ü satır sonu olmadan gönderin, çünkü birçok API hâlâ data:application/pdf;base64, önekini taşıyan bir değeri reddeder. İstek boyutu sınırlarını da göz önünde bulundurun: 7,5 MB'lık bir PDF yaklaşık 10 MB Base64'e dönüşür.

Base64 PDF'yi tanıma

Bir PDF dosyası %PDF- karakterleri ve ardından gelen sürüm numarasıyla başlar. Bu baytlar Base64 olarak kodlandığında her zaman JVBERi0 ile başlayan bir dize verir. Bir API yanıtında, veritabanı sütununda veya log dosyasında JVBER ile başlayan uzun bir dize neredeyse kesinlikle bir PDF'dir. Aynı kontrol bir yükü göndermeden önce de işe yarar: dizeniz başka bir şeyle başlıyorsa yanlış veriyi kodlamış ya da veriyi iki kez kodlamış olabilirsiniz.

PDF'yi HTML'ye gömme

Data URI, barındırılacak ayrı bir dosyaya gerek kalmadan PDF'nin tamamını bir HTML sayfasının içine yerleştirir:

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

Bu yöntem yerleşik PDF görüntüleyicisi olan masaüstü tarayıcılarda çalışır, ancak bazı sınırları vardır. Birçok mobil tarayıcı PDF'leri sayfa içinde hiç göstermez. Chrome ve bazı diğer tarayıcılar ayrıca bir sayfanın tüm sekmeyi bir data: URL'sine yönlendirmesini engeller; bu nedenle data:application/pdf URI'sini hedefleyen bir bağlantı veya window.open çağrısı boş bir sekme açabilir ya da hiçbir şey yapmayabilir. JavaScript ile bir PDF'yi yeni sekmede açmak için Base64'ü bunun yerine bir Blob URL'sine dönüştürün. Birkaç megabayttan büyük belgeler için normal bir dosya URL'si genellikle daha iyi bir seçimdir.

Kodda PDF kodlama

# Python: JSON istek gövdesi oluşturma
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})

// Tarayıcı: file, bir <input type="file"> öğesinden gelir
const reader = new FileReader();
reader.onload = () => {
  const pdfBase64 = reader.result.split(',')[1]; // data URI önekini atar
};
reader.readAsDataURL(file);