Comment Utiliser un PDF Base64 dans une Requête API JSON
Apprenez à structurer un payload JSON avec un PDF encodé en Base64, à l'envoyer depuis un client et à le décoder en fichier sur le serveur.
- pdf base64 api
- pdf base64 json
- envoyer pdf dans requete api
- decoder pdf base64 serveur
- pdf me
Pourquoi les API Encodent les Fichiers en Base64
Les API REST et JSON sont conçues autour du texte, pas du binaire brut, donc il n'existe pas de moyen natif de placer directement les octets d'un PDF dans un champ JSON. Encoder d'abord le fichier en Base64 le transforme en chaîne, que JSON traite comme n'importe quelle autre valeur texte.
Si vous n'avez pas encore converti de fichier, le guide PDF en Base64 couvre l'étape de conversion elle-même.
Structurer le Corps de la Requête
Une requête typique associe la chaîne encodée à quelques champs de métadonnées : un champ — souvent nommé file, document ou content — contient le texte Base64, un champ filename porte le nom de fichier d'origine, et un champ contentType ou mimeType défini sur application/pdf indique au destinataire comment interpréter les octets une fois décodés.
Gardez le champ encodé comme une chaîne unique et ininterrompue. Les sauts de ligne ou les espaces supplémentaires insérés par un éditeur ou une étape de copier-coller corrompront la valeur avant même qu'elle n'atteigne le serveur.
Envoyer la Requête
La plupart des clients HTTP — fetch dans le navigateur, une bibliothèque HTTP côté serveur ou un outil comme curl — envoient le corps JSON de la même façon qu'ils envoient n'importe quel autre payload, à condition que l'en-tête Content-Type soit défini sur application/json. Le champ Base64 n'est qu'une longue chaîne à l'intérieur de ce corps.
Surveillez la taille totale de la requête : le PDF encodé fait partie du JSON, donc une pièce jointe volumineuse augmente directement la taille du corps, et certaines passerelles API ou proxys inverses imposent une taille de requête maximale.
Décoder sur le Serveur
La plupart des langages côté serveur incluent un décodeur Base64 intégré. Le décodage transforme la chaîne en les octets originaux exacts, que le serveur peut ensuite écrire sur disque, stocker dans une base de données, transmettre à un autre service ou diffuser en flux vers un client.
Si le fichier décodé ne s'ouvre pas comme un PDF valide, vérifiez un éventuel préfixe data URI resté en place ou une corruption de copier-coller — voir les problèmes courants de PDF en Base64.
Quand Utiliser un Envoi de Fichier à la Place
Pour les PDF volumineux, les envois fréquents ou les fichiers qui doivent être diffusés en flux plutôt que conservés entièrement en mémoire, un envoi multipart ou un téléversement direct vers un stockage convient généralement mieux que d'intégrer le fichier dans du JSON. Base64 dans JSON fonctionne mieux pour les fichiers petits à moyens déplacés occasionnellement — certificats, formulaires signés, rapports courts.