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: Metin Ersoy · 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
| Belirti | Olası 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ük | PDF sıkıştırma ile küçült |
| PDF boş ya da bozuk açılıyor | Metnin sonu kesilmiş | Yeniden kodla, değerin tamamını gönder |
| Türkçe karakterli dosya adı bozuk | Ad 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ç