CDRN

Een PDF coderen naar Base64

  • Dashboard
  • Documentatie
  • API
converteert een PDF naar een Base64 / Data URI string, ideaal om een document direct in HTML, JSON of een e-mail te embedden

Een PDF in Base64 coderen

Base64 is een codering die binaire gegevens als ASCII-tekst weergeeft (64 tekens: A-Z, a-z, 0-9, plus twee extra tekens). Een PDF-bestand, dat van nature binair is, kan niet direct in een HTML-e-mail, een JSON-payload of een XML-attribuut worden geplakt: het moet eerst worden geconverteerd naar tekst. Onze tool neemt uw PDF-bestand en geeft de Base64-weergave terug, klaar om te kopiëren.

Voor details over Base64 en het Data URI-formaat in het algemeen, raadpleeg onze Base64-tekstencoder die de principes diepgaand behandelt.

Waarom een PDF in Base64 coderen?

  • Een PDF integreren in een HTML-e-mail: sommige e-mailclients accepteren de Data URI-links of de inline gecodeerde bijlagen in MIME.
  • Een PDF opslaan in een tekstveld van een database (kolom TEXT of VARCHAR) wanneer de applicatiebeperking een binair type (BLOB) verbiedt.
  • Een PDF verzenden in een JSON-API-payload: JSON ondersteunt geen binair, dus elk bestand moet in Base64 worden doorgegeven.
  • Een PDF inbedden in een data:-URL: zeldzaam gebruik, voorbehouden voor zeer kleine bestanden, omdat URL's lengtelimieten hebben (typisch 2000 tot 8000 tekens afhankelijk van de browser en de server).

Data URI-formaat voor PDF

Een URL van het type Data URI sluit de inhoud van de PDF direct in de URL in: 

data:application/pdf;base64,JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI...

Het voorvoegsel data:application/pdf;base64, geeft de browser het MIME-type en de codering aan. U kunt deze URL direct in de adresbalk van een moderne browser plakken om de PDF te openen, of in het src-attribuut van een <iframe> of <embed> plaatsen.

Concrete gebruiksgevallen

  • Elektronische handtekeningen: de meeste signing-API's (DocuSign, Yousign, enz.) accepteren of vereisen de PDF in Base64 in de JSON-body van het verzoek.
  • Back-ups en archivering: een PDF serialiseren in een JSON-export of een geversioneerd tekstbestand in git (te vermijden voor grote volumes, maar handig voor test-fixtures).
  • Geautomatiseerde tests: een referentie-PDF rechtstreeks in een unit-test integreren zonder afhankelijk te zijn van een extern bestand.
  • Klantexports: een PDF aan serverkant genereren, deze in Base64 in het JSON-antwoord teruggeven, de client decodeert het en downloadt het zonder extra HTTP-oproep.

Nadelen om te kennen

  • Groottetoename: Base64 voegt ongeveer 33% toe aan het volume. Een PDF van 1 MB wordt een tekenreeks van 1,37 MB in Base64.
  • Geen HTTP-cache: een PDF die als Data URI in een HTML-pagina is ingebed, wordt opnieuw gedownload bij elke keer laden, in tegenstelling tot een bestand dat vanuit een klassieke URL wordt geserveerd met cache-headers.
  • Groottebeperkingen: het browsergeheugen, de maximale grootte van een POST aan de serverkant (upload_max_filesize en post_max_size in PHP), en de quota van de database (MySQL-rijgrootte bijvoorbeeld) kunnen snel worden overschreden op omvangrijke PDF's.
  • Niet geschikt voor grote bestanden: boven enkele MB, verkies een speciale opslag (S3, schijf) en geef een URL door in plaats van de gecodeerde inhoud.

Hoe u de tool gebruikt

  1. Klik op het upload-veld en selecteer uw PDF-bestand.
  2. De tool codeert de binaire inhoud in Base64 en toont het resultaat.
  3. U kunt kiezen om het voorvoegsel data:application/pdf;base64, al dan niet op te nemen, afhankelijk van uw gebruikscase (met voorvoegsel voor een Data URI, zonder voorvoegsel voor een JSON-payload).
  4. Kopieer de tekenreeks en plak deze waar u hem nodig hebt.

Veelgestelde vragen

Wat is de maximale PDF-grootte die wordt geaccepteerd?

De limiet hangt af van de serverconfiguratie. In de praktijk blijft u onder enkele MB om een vlotte ervaring te behouden. Daarboven vertraagt de browser, raakt het klembord verzadigd en kunnen de bestemmingen (e-mail, JSON, database) de lading weigeren.

Is de Base64 PDF compatibel met e-mailclients (Gmail, Outlook)?

Als bijlage inline gecodeerd in een MIME-bericht, ja: het is zelfs het standaardmechanisme van elektronische post. Daarentegen, in een Data URI in de HTML-body van een bericht (<a href="data:..."> of <iframe>), blokkeren de meeste e-mailclients of herschrijven ze deze URL's om veiligheidsredenen. Geef de voorkeur aan een klassieke bijlage.

Wat is het verschil met een versleutelde PDF?

In Base64 coderen is niet versleutelen: de tekenreeks blijft leesbaar en triviaal te decoderen door iedereen. Een versleutelde PDF (eigenaars- of gebruikerswachtwoord) blijft versleuteld zelfs na Base64-codering: codering en versleuteling zijn twee onafhankelijke bewerkingen.

Kan ik de omgekeerde bewerking uitvoeren?

Ja: gebruik onze Base64 PDF-decoder om een Base64-tekenreeks om te zetten in een downloadbaar PDF-bestand.

Wordt mijn PDF naar uw servers verzonden?

De codering wordt aan de serverkant verwerkt gedurende de tijd van de aanvraag, daarna wordt het bestand vrijgegeven. Geen permanente opslag wordt uitgevoerd. Voor bijzonder gevoelige PDF's geeft u de voorkeur aan een lokale verwerking met een offline tool.

Voorbeeldverzoek

curl -X POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute \
  -F "file=@/path/to/file"

Invoerschema

Veld Type Vereist Standaard
file file ✓ –

deze tool verwacht een bestand - gebruik Content-Type multipart/form-data in plaats van application/json

Endpoints

  • GET https://cdrn.fr/api/v1/tools - toont alle beschikbare tools
  • GET https://cdrn.fr/api/v1/tools/base64-pdf-encoder - geeft het schema van deze tool terug
  • POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute - voert deze tool uit met een JSON-payload