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

PDF API'ye Base64 olarak nasıl gönderilir?

E-fatura, e-imza ya da kargo API'si belgeyi bir JSON alanında istiyor. PDF'i doğru metne çevirmeyi, kontrol etmeyi ve isteği bozan hatalardan kaçınmayı adım adım anlatıyoruz.

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

API genellikle ne bekler?

Belge alan API'lerin çoğu content, file, data ya da document adlı bir alanı olan bir JSON gövdesi tarif eder. Alanın değeri PDF'in Base64 kodudur; yanında çoğu zaman dosya adı ve tür bulunur:

{
  "fileName": "fatura-1024.pdf",
  "mimeType": "application/pdf",
  "content": "JVBERi0xLjcKJ..."
}

Kod yazmadan önce belgelerde üç şeye bak: alanın adı, data: öneki isteniyor mu (çoğu zaman hayır) ve boyut sınırı.

1. PDF'i Base64'e çevir

Deneme değeri almanın en hızlı yolu PDF'i Base64'e çevirme aracıdır. PDF'i seç, Yalnızca Base64 kodunu işaretle ve sonucu kopyala. Üzerinde çalışmak için hazır bir istek gövdesi istiyorsan JSON seçeneğini kullan; dosya adını ve türü senin yerine ekler. PDF tarayıcında kodlanır ve hiçbir yere yüklenmez; deneme belgesi gerçek bir faturaysa bu önemlidir.

Sonucu kontrol et: JVBERi0 ile başlamalı, boşluk içermemeli ve sondaki bir iki = işareti dışında yalnızca harf, rakam, + ve / olmalı.

2. Kendi kodundan gönder

Aynı adım üç yaygın dilde. Her biri dosyayı okur, kodlar ve JSON'u gönderir:

# curl (Linux / macOS): base64 -w 0 kodu tek satırda tutar
curl -X POST https://api.example.com/documents \
  -H "Content-Type: application/json" \
  -d "{\"fileName\":\"fatura.pdf\",\"content\":\"$(base64 -w 0 fatura.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('fatura.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ fileName: 'fatura.pdf', content }),
});
# Python 3, requests kütüphanesiyle
import base64, requests
with open("fatura.pdf", "rb") as f:
    content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
              json={"fileName": "fatura.pdf", "content": content})

macOS'ta curl satırında -w 0 yerine base64 -i fatura.pdf yazılır. Adres ve alan adları örnektir; kendi servisinin belgelerindekileri kullan.

3. Gidiş-dönüşü kontrol et

Servis belgeyi ya da kaydedilen kopyasını Base64 olarak geri veriyorsa o yanıtı Base64'ü PDF'e çevirme aracına yapıştır. İlk sayfayı ve sayfa sayısını görmek, yolda hiçbir şeyin kaybolmadığının en hızlı kanıtıdır. Bu yönün ayrıntılı adımları Base64 kodu PDF dosyası olarak nasıl kaydedilir? rehberinde.

Sık yapılan hatalar

BelirtiOlası nedenÇözüm
"Geçersiz Base64"Satır sonları (76 karakterlik satırlar) ya da data: önekiÖneksiz kodu tek satırda gönder
"Payload too large" (413)PDF kodlandıktan sonra çok büyükPDF sıkıştırma ile küçült
PDF boş ya da bozuk açılıyorMetnin sonu kesilmişYeniden kodla, değerin tamamını gönder
Türkçe karakterli dosya adı bozukAd yanlış kodlamayla gönderilmişJSON gövdesini UTF-8 tut

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

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

PDF'i Base64 olarak gönderme hakkında sorular

API'ler neden dosya yerine Base64 istiyor?

JSON yalnızca metin taşıyabilir. Base64, PDF'in baytlarını harf, rakam, + ve / ile yazar; böylece belge, müşteri numarası ya da fatura tarihi gibi diğer bilgilerin yanında tek bir metin alanına sığar.

data:application/pdf;base64, önekini de göndermeli miyim?

Genellikle hayır. API'lerin çoğu yalnızca JVBERi0 ile başlayan kodu bekler. Data URI'yi yalnızca belgelerde öyle gösteriliyorsa ya da tarayıcıda bir adres gerekiyorsa (ör. iframe) kullan.

API Base64'ün geçersiz olduğunu söylüyor. En sık neden ne?

Metnin içinde satır sonu ya da önek kalması veya kodun yapıştırılırken sonunun kesilmesi. Kodu tek satır ve öneksiz gönder; metnin sonunun eksiksiz ulaştığını kontrol et.

PDF en fazla ne kadar büyük olabilir?

Servise göre değişir; ama metin dosyadan yaklaşık üçte bir büyüktür, yani 3 MB'lık PDF yaklaşık 4 MB JSON eder. Birçok API birkaç megabaytta durur; en kolay çözüm PDF'i önce sıkıştırmaktır.

Base64 bir şifreleme mi?

Hayır. Kodu olan herkes onu belgeye geri çevirebilir. Yalnızca HTTPS üzerinden gönder ve gizli bir PDF'i dosyayı sunucuya yükleyen bir siteye yapıştırma.