Quand a-t-on besoin d'un PDF en Base64 ?
JSON, XML et de nombreux formulaires ne peuvent transporter que du texte : un fichier binaire comme un PDF doit donc d'abord être écrit sous forme de texte. Le Base64 est la méthode habituelle pour cela :
- Envoyer un document à une API. Les services de facture électronique, de signature électronique, d'expédition ou de gestion documentaire demandent souvent le PDF dans un champ nommé content, file ou data.
- Tester votre propre intégration. Avec l'option JSON, vous obtenez un corps de requête prêt à coller dans Postman, curl ou un test unitaire, sans écrire une ligne de code d'encodage.
- Stocker dans une colonne texte ou un fichier de configuration. Certains systèmes conservent de petits modèles ou des certificats sous forme de texte ; le Base64 permet d'y faire entrer le PDF.
- Intégrer dans une page web. Une URI de données permet à une page d'afficher un PDF dans une iframe sans héberger de fichier séparé, ce qui convient aux petits documents.
Des exemples de requêtes pas à pas en curl, JavaScript et Python se trouvent dans comment envoyer un PDF à une API en Base64. Pour retransformer le code en fichier, utilisez Base64 en PDF ; pour les images, voyez Image en Base64.
À quoi ressemble chaque format
| Format | Commence par | Usage typique |
|---|---|---|
| Code Base64 seul | JVBERi0 | Champs d'API, JSON, XML, bases de données |
| URI de données | data:application/pdf;base64, | Onglet du navigateur, iframe, balise object |
| Lignes de 76 caractères | JVBERi0, découpé en lignes courtes | Pièces jointes d'e-mail (MIME), fichiers de type PEM |
| JSON | { "fileName": … } | Corps de requête pour tester une intégration |
En cas de problème
« Impossible d'ouvrir ce fichier en tant que PDF. » Le fichier ne commence pas par la signature %PDF- : c'est peut-être un fichier Word ou une image renommés en .pdf. Ouvrez-le d'abord dans un lecteur PDF, ou convertissez-le avec l'outil adapté.
L'API indique que le contenu n'est pas valide. Vérifiez que vous avez envoyé le code brut, sans le préfixe data: et sans retours à la ligne, sauf si la documentation les demande. Assurez-vous aussi que rien n'a été coupé à la fin au moment du collage.
Le texte est trop long pour le champ. Réduisez le PDF avec Compresser PDF puis convertissez-le à nouveau ; le code raccourcit dans la même proportion.