Envoyer un PDF à une API en Base64
Une API de facture électronique, de signature électronique ou d'expédition attend le document dans un champ JSON. Voici comment transformer le PDF en texte au bon format, le vérifier et éviter les erreurs qui font échouer la requête.
Par Metin Ersoy · Mis à jour le 10 novembre 2026
Ce que l'API attend en général
La plupart des API de documents décrivent un corps JSON avec un champ appelé content, file, data ou document. Sa valeur est le code Base64 du PDF, souvent accompagné d'un nom de fichier et d'un type :
{
"fileName": "invoice-1024.pdf",
"mimeType": "application/pdf",
"content": "JVBERi0xLjcKJ..."
}
Avant d'écrire la moindre ligne de code, cherchez trois informations dans la documentation : le nom du champ, si un préfixe data: est demandé (en général, non) et la limite de taille.
1. Convertir le PDF en Base64
Le moyen le plus rapide d'obtenir une valeur de test est l'outil PDF en Base64. Choisissez le PDF, sélectionnez Code Base64 seul et copiez le résultat. Si vous préférez partir d'un corps de requête complet, choisissez plutôt JSON : le nom du fichier et le type sont ajoutés pour vous. Le PDF est encodé dans votre navigateur et n'est envoyé nulle part, ce qui compte lorsque le document de test est une vraie facture.
Vérifiez le résultat : il doit commencer par JVBERi0, ne contenir aucune espace et, à part un ou deux signes = à la fin, uniquement des lettres, des chiffres, + et /.
2. L'envoyer depuis votre code
La même étape dans trois langages courants. Chaque exemple lit le fichier, l'encode et envoie le JSON :
# curl (Linux / macOS) : base64 -w 0 garde tout sur une seule ligne
curl -X POST https://api.example.com/documents \
-H "Content-Type: application/json" \
-d "{\"fileName\":\"invoice.pdf\",\"content\":\"$(base64 -w 0 invoice.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('invoice.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ fileName: 'invoice.pdf', content }),
});
# Python 3 avec requests
import base64, requests
with open("invoice.pdf", "rb") as f:
content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
json={"fileName": "invoice.pdf", "content": content})
Sur macOS, la ligne curl utilise base64 -i invoice.pdf au lieu de -w 0. L'adresse et les noms de champs sont des exemples : reprenez ceux de la documentation de votre service.
3. Vérifier l'aller-retour
Si le service renvoie le document ou une copie enregistrée en Base64, collez cette réponse dans Base64 en PDF. Voir la première page et le nombre de pages est la preuve la plus rapide que rien ne s'est perdu en route. Les étapes détaillées pour ce sens-là se trouvent dans Comment enregistrer un code Base64 en fichier PDF.
Erreurs fréquentes
| Symptôme | Cause probable | Solution |
|---|---|---|
| « Invalid Base64 » | Retours à la ligne (lignes de 76 caractères) ou préfixe data: | Envoyez le code brut sur une seule ligne |
| « Payload too large » (413) | Le PDF est trop lourd une fois encodé | Allégez-le avec Compresser PDF |
| Le PDF s'ouvre vide ou abîmé | La chaîne a été tronquée | Encodez à nouveau et envoyez la valeur entière |
| Les noms accentués s'affichent mal | Nom de fichier envoyé dans un mauvais encodage | Gardez le corps JSON en UTF-8 |
Envie d’essayer ? C’est gratuit, et votre fichier reste sur votre appareil.
Ouvrir PDF en Base64