PDF'in Base64 hâli ne zaman gerekir?
JSON, XML ve birçok form yalnızca metin taşıyabilir; PDF gibi ikili bir dosyanın önce metin olarak yazılması gerekir. Bunun en yaygın yolu Base64'tür:
- Belgeyi bir API'ye göndermek. E-fatura, e-imza, kargo ve belge yönetimi servisleri PDF'i çoğu zaman content, file ya da data adlı bir alanda ister.
- Kendi entegrasyonunu denemek. JSON seçeneğiyle Postman'e, curl komutuna ya da bir birim testine yapıştırabileceğin hazır bir istek gövdesi alırsın; kodlama için tek satır yazman gerekmez.
- Metin sütununda ya da ayar dosyasında saklamak. Bazı sistemler küçük şablonları veya belgeleri metin olarak tutar; Base64 PDF'i buna sığdırır.
- Web sayfasına gömmek. Data URI, ayrı bir dosya barındırmadan PDF'i bir iframe içinde göstermeye yarar; küçük belgeler için uygundur.
curl, JavaScript ve Python ile istek örnekleri PDF API'ye Base64 olarak nasıl gönderilir? rehberinde. Kodu yeniden dosyaya çevirmek için Base64'ü PDF'e çevirme aracını, resimler için Resmi Base64'e çevirme aracını kullanabilirsin.
Biçimler nasıl görünür?
| Biçim | Şununla başlar | Nerede kullanılır |
|---|---|---|
| Yalnızca Base64 kodu | JVBERi0 | API alanları, JSON, XML, veritabanı |
| Data URI | data:application/pdf;base64, | Tarayıcı sekmesi, iframe, object etiketi |
| 76 karakterlik satırlar | JVBERi0, kısa satırlara bölünmüş | E-posta ekleri (MIME), PEM benzeri dosyalar |
| JSON | { "fileName": … } | Entegrasyon denemesi için istek gövdesi |
Bir şey ters giderse
"Bu dosya geçerli bir PDF değil." Dosya %PDF- imzasıyla başlamıyor; uzantısı .pdf yapılmış bir Word dosyası ya da resim olabilir. Önce bir PDF okuyucuda aç ya da uygun araçla PDF'e çevir.
API içeriğin geçersiz olduğunu söylüyor. Belgeler aksini istemiyorsa kodu data: öneki ve satır sonları olmadan gönderdiğinden emin ol. Yapıştırırken sonunun kesilmediğini de kontrol et.
Metin alana sığmıyor. PDF'i PDF sıkıştırma ile küçültüp yeniden çevir; kod da aynı oranda kısalır.