CDRN

Codificare un PDF in Base64

  • Dashboard
  • Documentazione
  • API
converte un PDF in una stringa Base64 / Data URI, ideale per integrare un documento direttamente in HTML, JSON o un'email

Encoder un PDF en Base64

Le Base64 est un encodage qui représente des données binaires sous forme de texte ASCII (64 caractères : A-Z, a-z, 0-9, plus deux caractères additionnels). Un fichier PDF, qui est binaire par nature, ne peut pas être collé directement dans un email HTML, une payload JSON ou un attribut XML : il doit d'abord être converti en texte. Notre outil prend votre fichier PDF et renvoie sa représentation Base64, prête à être copiée.

Pour les détails sur Base64 et le format Data URI en général, consultez notre encodeur Base64 texte qui couvre les principes en profondeur.

Pourquoi encoder un PDF en Base64 ?

  • Intégrer un PDF dans un email HTML : certains clients mail acceptent les liens Data URI ou les pièces jointes encodées inline en MIME.
  • Stocker un PDF dans un champ texte de base de données (colonne TEXT ou VARCHAR) lorsque la contrainte applicative interdit un type binaire (BLOB).
  • Transmettre un PDF dans une payload JSON d'API : JSON ne supporte pas le binaire, donc tout fichier doit transiter en Base64.
  • Embarquer un PDF dans une URL data: usage rare, à réserver aux très petits fichiers, parce que les URL ont des limites de longueur (typiquement 2000 à 8000 caractères selon le navigateur et le serveur).

Format Data URI pour PDF

Une URL de type Data URI embarque le contenu du PDF directement dans l'URL : 

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

Le préfixe data:application/pdf;base64, indique au navigateur le type MIME et l'encodage. Vous pouvez coller cette URL directement dans la barre d'adresse d'un navigateur moderne pour ouvrir le PDF, ou la placer dans l'attribut src d'un <iframe> ou <embed>.

Cas d'usage concrets

  • Signatures électroniques : la plupart des API de signature (DocuSign, Yousign, etc.) acceptent ou exigent le PDF en Base64 dans le corps JSON de la requête.
  • Backups et archivage : sérialiser un PDF dans un export JSON ou un fichier texte versionné en git (à éviter pour les gros volumes, mais pratique pour des fixtures de test).
  • Tests automatisés : intégrer un PDF de référence directement dans un test unitaire sans dépendre d'un fichier externe.
  • Exports clients : générer un PDF côté serveur, le renvoyer en Base64 dans la réponse JSON, le client le décode et le télécharge sans appel HTTP supplémentaire.

Inconvénients à connaître

  • Surcoût de taille : Base64 ajoute environ 33 % au volume. Un PDF de 1 Mo devient une chaîne de 1,37 Mo en Base64.
  • Pas de cache HTTP : un PDF embarqué en Data URI dans une page HTML est re-téléchargé à chaque chargement, contrairement à un fichier servi depuis une URL classique avec en-têtes de cache.
  • Limites de taille : la mémoire navigateur, la taille maximale d'un POST côté serveur (upload_max_filesize et post_max_size en PHP), et les quotas de la base de données (taille de ligne MySQL, par exemple) peuvent vite être dépassés sur des PDF volumineux.
  • Pas adapté aux gros fichiers : au-delà de quelques Mo, préférez un stockage dédié (S3, disque) et transmettez une URL plutôt que le contenu encodé.

Comment utiliser l'outil

  1. Cliquez sur le champ d'upload et sélectionnez votre fichier PDF.
  2. L'outil encode le contenu binaire en Base64 et affiche le résultat.
  3. Vous pouvez choisir d'inclure ou non le préfixe data:application/pdf;base64, selon votre cas d'usage (avec préfixe pour un Data URI, sans préfixe pour une payload JSON).
  4. Copiez la chaîne et collez-la là où vous en avez besoin.

Questions fréquentes

Quelle est la taille maximale de PDF acceptée ?

La limite dépend de la configuration serveur. En pratique, restez sous quelques Mo pour garder une expérience fluide. Au-delà, le navigateur ralentit, le presse-papier sature, et les destinations (email, JSON, base de données) risquent de rejeter la charge.

Le PDF Base64 est-il compatible avec les clients mail (Gmail, Outlook) ?

En tant que pièce jointe encodée inline dans un message MIME, oui : c'est même le mécanisme standard du courrier électronique. En revanche, en Data URI dans le corps HTML d'un message (<a href="data:..."> ou <iframe>), la plupart des clients mail bloquent ou réécrivent ces URL pour des raisons de sécurité. Préférez la pièce jointe classique.

Quelle différence avec un PDF chiffré ?

Encoder en Base64 n'est pas chiffrer : la chaîne reste lisible et triviale à décoder par n'importe qui. Un PDF chiffré (mot de passe propriétaire ou utilisateur) reste chiffré même après encodage Base64 : l'encodage et le chiffrement sont deux opérations indépendantes.

Puis-je faire l'opération inverse ?

Oui : utilisez notre décodeur PDF Base64 pour transformer une chaîne Base64 en fichier PDF téléchargeable.

Mon PDF est-il envoyé sur vos serveurs ?

L'encodage est traité côté serveur le temps de la requête, puis le fichier est libéré. Aucun stockage persistant n'est effectué. Pour des PDF particulièrement sensibles, privilégiez un traitement local avec un outil hors ligne.

Esempio di richiesta

curl -X POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute \
  -H "Content-Type: application/json" \
  -d '{"file":"..."}'

Schema di input

Campo Tipo Richiesto Predefinito
file file ✓ –

questo strumento si aspetta un file - utilizzare Content-Type multipart/form-data invece di application/json

Endpoint

  • GET https://cdrn.fr/api/v1/tools - elenca tutti gli strumenti disponibili
  • GET https://cdrn.fr/api/v1/tools/base64-pdf-encoder - recupera lo schema di questo strumento
  • POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute - esegue questo strumento con un payload JSON