Konwerter PDF na Base64

Przesyłanie plików PDF przez API JSON

JSON nie ma typu binarnego, dlatego interfejsy REST API przyjmujące dokumenty zwykle oczekują ich w postaci ciągu Base64. Platformy podpisu elektronicznego, systemy fakturowania i e-faktur, usługi drukowania i wysyłki korespondencji, silniki OCR oraz archiwa dokumentów często przyjmują pliki PDF właśnie w ten sposób, w polu takim jak content, file lub documentBase64, z nazwą pliku w osobnym polu. Niektóre usługi w ten sam sposób zwracają pliki PDF; narzędzie Base64 na PDF zamienia je z powrotem na pliki.

Wysyłaj czysty Base64 bez podziałów wierszy, chyba że dokumentacja API stanowi inaczej, ponieważ wiele interfejsów API odrzuca wartość, która nadal zawiera prefiks data:application/pdf;base64,. Pamiętaj też o limitach rozmiaru żądań: plik PDF o rozmiarze 7,5 MB to około 10 MB tekstu Base64.

Jak rozpoznać PDF zakodowany w Base64

Plik PDF zaczyna się od znaków %PDF-, po których następuje numer wersji. Po zakodowaniu w Base64 te bajty zawsze dają ciąg zaczynający się od JVBERi0. Długi ciąg zaczynający się od JVBER w odpowiedzi API, kolumnie bazy danych lub pliku dziennika to niemal na pewno PDF. Ten sam test działa przed wysłaniem danych: jeśli ciąg zaczyna się od czegokolwiek innego, być może zakodowano niewłaściwe dane albo zakodowano je dwukrotnie.

Osadzanie pliku PDF w HTML

Data URI umieszcza cały plik PDF wewnątrz strony HTML, bez osobnego pliku, który trzeba by hostować:

<embed src="data:application/pdf;base64,JVBERi0..." type="application/pdf" width="100%" height="600">

<iframe src="data:application/pdf;base64,JVBERi0..." width="100%" height="600"></iframe>

Działa to w przeglądarkach na komputery z wbudowaną przeglądarką PDF, ale ma swoje ograniczenia. Wiele przeglądarek mobilnych w ogóle nie wyświetla plików PDF wewnątrz strony. Chrome i niektóre inne przeglądarki blokują też stronom przekierowywanie całej karty na adres data:, więc link lub wywołanie window.open wskazujące na URI data:application/pdf może otworzyć pustą kartę albo nic nie zrobić. Aby otworzyć PDF w nowej karcie z poziomu JavaScriptu, przekonwertuj Base64 na adres URL typu Blob. W przypadku dokumentów większych niż kilka megabajtów lepszym wyborem jest zazwyczaj standardowy adres URL pliku.

Kodowanie pliku PDF w kodzie

# Python: tworzenie treści żądania JSON
import base64, json
from pathlib import Path

pdf_b64 = base64.b64encode(Path('invoice.pdf').read_bytes()).decode('ascii')
body = json.dumps({'filename': 'invoice.pdf', 'content': pdf_b64})

// Przeglądarka: plik pochodzi z elementu <input type="file">
const reader = new FileReader();
reader.onload = () => {
  const pdfBase64 = reader.result.split(',')[1]; // usunięcie prefiksu data URI
};
reader.readAsDataURL(file);