Kiedy potrzebujesz pliku PDF w Base64?
JSON, XML i wiele formularzy przenosi wyłącznie tekst, więc plik binarny, taki jak PDF, trzeba najpierw zapisać jako tekst. Zwykle robi się to właśnie w Base64:
- Wysyłanie dokumentu do API. Usługi e-faktur, podpisów elektronicznych, firm kurierskich i systemów obiegu dokumentów często wymagają pliku PDF w polu o nazwie content, file lub data.
- Testowanie własnej integracji. Opcja JSON daje gotową treść żądania do wklejenia w Postmanie, w curlu lub w teście jednostkowym – bez pisania własnej funkcji kodującej.
- Zapis w kolumnie tekstowej lub konfiguracji. Niektóre systemy przechowują małe szablony lub certyfikaty jako tekst; dzięki Base64 zmieści się tam też plik PDF.
- Osadzenie na stronie internetowej. Data URI pozwala wyświetlić plik PDF w ramce iframe bez umieszczania osobnego pliku na serwerze – dobre rozwiązanie dla małych dokumentów.
Przykłady żądań krok po kroku z użyciem curla, JavaScriptu i Pythona znajdziesz w poradniku Jak wysłać plik PDF do API jako Base64. Aby zamienić kod z powrotem na plik, użyj narzędzia Base64 na PDF; dla obrazów zobacz Obraz na Base64.
Jak wyglądają poszczególne formaty
| Format | Zaczyna się od | Typowe zastosowanie |
|---|---|---|
| Sam kod Base64 | JVBERi0 | Pola API, JSON, XML, bazy danych |
| Data URI | data:application/pdf;base64, | Karta przeglądarki, iframe, znacznik object |
| Wiersze po 76 znaków | JVBERi0, podzielone na krótkie wiersze | Załączniki e-mail (MIME), pliki w stylu PEM |
| JSON | { "fileName": … } | Treść żądania do testowania integracji |
Jeśli coś pójdzie nie tak
„Nie udało się otworzyć tego pliku jako PDF.” Plik nie zaczyna się od sygnatury %PDF- – może to być plik Worda lub obraz, któremu zmieniono rozszerzenie na .pdf. Najpierw otwórz go w czytniku PDF albo przekonwertuj właściwym narzędziem.
API zgłasza, że zawartość jest nieprawidłowa. Sprawdź, czy wysyłasz sam kod, bez prefiksu data: i bez podziałów wierszy, chyba że dokumentacja ich wymaga. Upewnij się też, że przy wklejaniu nic nie zostało ucięte na końcu.
Tekst jest za długi dla pola. Zmniejsz plik PDF narzędziem Kompresuj PDF i zakoduj go ponownie – kod skróci się w tej samej proporcji.