PDFVela — pdfvela.com
Tüm PDF araçları

Base64 kodu PDF dosyası olarak nasıl kaydedilir?

Bir API yanıtında, e-fatura XML'inde ya da e-postanın ham kaynağında JVBERi0 ile başlayan uzun bir metin var ve içindeki belgeye ihtiyacın var — kodu bulmaktan dosyayı açmaya kadar.

Yazan: · Güncelleme: 10 Kasım 2026

Base64 PDF nedir, neden metin olarak geliyor?

Base64, bir dosyayı yalnızca harf, rakam ve birkaç işaretle yazmanın bir yoludur. JSON, XML ve e-posta gibi yalnızca metin taşıyabilen biçimler bu sayede bir PDF'i de içinde götürebilir. Kod, belgenin bayt bayt aynısını taşır; geri çözüldüğünde özgün dosya eksiksiz ortaya çıkar, elektronik imzalar da geçerliliğini korur.

Türkiye'de bu durumla en sık şu yerlerde karşılaşırsın:

  • E-fatura ve e-arşiv: Entegratörlerin ve muhasebe yazılımlarının API'leri faturanın PDF hâlini Base64 alanıyla döndürür. UBL XML dosyasının içinde de faturanın görüntüsü Base64 olarak gömülü olabilir.
  • Kargo ve lojistik: Gönderi oluşturulduğunda kargo etiketi çoğu zaman Base64 PDF olarak gelir.
  • Ödeme ve banka entegrasyonları: Dekont, makbuz ve hesap dökümü servisleri belgeyi metin alanında verebilir.
  • E-imza ve belge yönetimi: İmzalanan belge, imza servisinden yine Base64 olarak geri döner.
  • E-posta kaynağı: Bir e-postanın ham hâlinde PDF ekleri, Base64 bloğu olarak durur.

1. Kodu bul ve tamamını kopyala

  • JSON yanıtı: PDF'in olduğu alanı bul; adı çoğu zaman pdf, content, data, document, file ya da label gibidir. Değer JVBERi0 ile başlar. Tırnak işaretleri arasındaki metnin tamamını kopyala. İstersen yanıtın tamamını da kopyalayabilirsin; araç JVBERi0 ile başlayan kısmı kendisi bulur.
  • XML dosyası: PDF'i taşıyan etiketi bul (ör. EmbeddedDocumentBinaryObject). Açılış ve kapanış etiketleri arasındaki metni kopyala; satırlara bölünmüş olması sorun değildir.
  • E-posta kaynağı: "Orijinali göster" ya da "Kaynağı görüntüle" seçeneğini aç. PDF eki, Content-Type: application/pdf ve Content-Transfer-Encoding: base64 satırlarının altındaki bloktur. Bir sonraki boş satıra kadar olan her şeyi kopyala.
  • Geliştirici araçları: Tarayıcının ağ sekmesinde yanıtı aç, alanın üzerine sağ tıklayıp "değeri kopyala" (Copy value) seçeneğini kullan. Uzun metinleri elle seçmekten daha güvenilirdir.

Kodun sonu çok uzun olduğu için kolayca kesilir. Kopyaladıktan sonra yapıştırdığın metnin, kaynaktaki gibi bittiğini kontrol et.

2. Kodu çevir ve belgeyi kontrol et

Base64'ü PDF'e çevirme aracını aç, "Ya da metni yaz / yapıştır" butonuna bas ve kodu yapıştır. Kod çözülür çözülmez belgenin ilk sayfası görünür; altında sayfa sayısı, PDF sürümü ve dosya boyutu yazar. Kod bir .txt dosyasında duruyorsa dosyayı seçmen de yeterli.

Önizleme şunları hızlıca kontrol etmeni sağlar:

  • Doğru belge mi? Fatura numarası, alıcı adı ya da etiket bilgisi ilk sayfada görünür.
  • Sayfa sayısı beklediğin gibi mi? Eksik sayfa, kodun yarım kopyalandığını gösterir.
  • Belge parola korumalı mı? Bu durumda önizleme yerine bir not çıkar, dosya yine olduğu gibi kaydedilir.

3. PDF'i kaydet ve aç

"PDF'i indir" butonuna bas. Dosya, kodlandığı hâliyle değişmeden kaydedilir ve her PDF okuyucuda açılır. Sonrasında belgeyle ne yapacağın sana kalmış: PDF birleştirme ile aynı aya ait faturaları tek dosyada toplayabilir, PDF sıkıştırma ile e-postaya sığacak hâle getirebilir ya da PDF'ten JPG'ye ile ilk sayfanın resmini alabilirsin.

Kodun başı neyi gösterir?

Kod şununla başlıyorİçindeki dosya
JVBERi0PDF belgesi
data:application/pdf;base64,PDF belgesi (data URI)
iVBORw0KGgoPNG resim
/9j/JPG fotoğraf
UEsDBZIP, Word (.docx) ya da Excel (.xlsx)
PD94bWwgXML metni (ör. faturanın kendisi)

Son satır, e-faturalarda sık yaşanan bir karışıklığı açıklar: bazı servisler PDF yerine faturanın XML'ini Base64 olarak gönderir. Bu kod çözüldüğünde PDF değil, okunabilir bir XML metni çıkar.

Sık yapılan hatalar

Kodu .pdf uzantılı metin dosyası olarak kaydetmek. Dosyanın içinde yine Base64 metni durur; PDF okuyucu "dosya bozuk" der. Kodun çözülmesi gerekir.

Tırnak dışındaki bir alanı da kopyalamak. Kodun sonuna "," ya da "status" gibi bir parça karışırsa kod geçersiz olur. Ya yalnızca değeri, ya da yanıtın tamamını kopyala; araç ikisini de doğru ayıklar.

Kaçışlı satır sonları. JSON metinlerinde kod 76 karakterde bir \n ile bölünmüş olabilir. Bu karakterler PDF'in parçası değildir; araç onları kendiliğinden temizler.

Yanlış servis yanıtı. Bazı API'ler belge hazır değilse boş bir alan ya da hata mesajı döndürür. Kod çok kısaysa (birkaç yüz karakter) büyük ihtimalle PDF değil, bir hata metnidir.

Gizlilik notu

Base64 belgeni korumaz; yalnızca biçimini değiştirir. Fatura, sözleşme, sağlık raporu ya da kimlik fotokopisi gibi kişisel veri içeren belgeleri dosyayı sunucuya yükleyen sitelerde çözmekten kaçın. PDFVela'nın aracı kodu cihazında çözer; sayfa açıldıktan sonra internet bağlantını kessen de çalışır.

Denemeye hazır mısın? Ücretsiz ve dosyan cihazında kalır.

Base64'ü PDF'e çevirme aracını aç

Base64 kodunu PDF'e çevirme hakkında sorular

Bir metnin Base64 PDF olduğunu nasıl anlarım?

En güvenilir işaret JVBERi0 ile başlamasıdır; bu, her PDF'in ilk karakterleri olan %PDF- yazısının Base64 hâlidir. Metin data:application/pdf;base64, ile başlıyorsa da PDF'tir. Kod yalnızca harf, rakam, + ve / içerir; sonunda bir ya da iki = olabilir.

Kodu bir .pdf dosyasına yapıştırıp kaydetsem olmaz mı?

Olmaz. Not Defteri'nde metni .pdf uzantısıyla kaydetmek, dosyanın içine yine metni yazar; PDF okuyucu onu açamaz. Kodun önce çözülüp baytlara dönüştürülmesi gerekir. Base64'ü PDF'e çevirme aracı bunu tarayıcında yapar.

E-fatura ya da e-arşiv XML'inde PDF nerede durur?

Faturanın görsel hâli çoğu zaman EmbeddedDocumentBinaryObject benzeri bir etiketin içinde, mimeCode="application/pdf" bilgisiyle durur. Etiketin içindeki metnin tamamı PDF'in Base64 kodudur. Bazı hizmetler PDF yerine HTML ya da XSLT gönderir; o durumda kod JVBERi0 ile başlamaz.

Bu belge gizli, güvenli mi?

PDFVela'nın aracı kodu kendi cihazında çözer; metin de belge de hiçbir sunucuya gönderilmez. Base64 bir şifreleme değildir, kodu olan herkes belgeyi açabilir. Bu yüzden faturayı, sözleşmeyi ya da kimlik belgesini bilmediğin bir siteye yapıştırmadan önce dosyanın yüklenip yüklenmediğini kontrol et.

Kodun içinde resim varsa ne yaparım?

iVBORw0KGgo (PNG) ya da /9j/ (JPG) ile başlayan kod bir resimdir. Base64'ü PDF'e çevirme aracı bunu fark eder ve seni Base64'ü resme çevirme aracına yönlendirir. Resmi kaydettikten sonra istersen JPG'den PDF'e aracıyla PDF yapabilirsin.