Base64 dans les charges utiles d'API: avantages, inconvénients et frais généraux

Base64 dans les Payloads d'API : avantages, inconvénients et surcoût

Base64 encode les données binaires arbitraires en texte ASCII imprimable. Il est partout dans le développement web -- mais souvent utilisé là où il ne devrait pas l'être. Voici quand l'utiliser, quand l'éviter et ce qu'il coûte réellement.

Comment fonctionne Base64

Base64 prend 3 octets d'entrée et les encode en 4 caractères ASCII à partir d'un alphabet à 64 caractères (A-Z, a-z, 0-9, +, /). Le padding avec = lorsque l'entrée n'est pas un multiple de 3.

Entrée :   3 octets  →  4 caractères
Ratio :   33% augmentation de taille
1 MB binaire  →  ~1,33 MB texte Base64

Cette augmentation de 33% est le prix de la compatibilité ASCII.

Quand utiliser Base64

Insérer des images dans JSON

{
  "avatar": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
}

JSON ne peut pas contenir de données binaires brutes. Base64 est la seule option pour les données binaires en ligne.

Pièces jointes par courriel (MIME)

SMTP est un protocole de texte. Chaque pièce jointe est encodée en Base64 dans le corps MIME.

URIs de données dans CSS/HTML

background-image: url('data:image/svg+xml;base64,PHN2Zy...');

Petits icônes (< 2KB) comme URIs de données économisent une requête HTTP.

Payloads JWT

L'en-tête et le payload d'un JWT sont encodés en Base64url en JSON. Cela permet un transport sûr dans les URL, les en-têtes et les cookies.

Quand NE PAS utiliser Base64

Fichiers volumineux -- un fichier d'image de 10 MB devient 13,3 MB en texte Base64. Utilisez multipart/form-data pour les téléchargements de fichiers :

POST /upload
Content-Type: multipart/form-data; boundary=----

Lorsque vous contrôlez les deux extrémités -- si votre client et serveur API gèrent tous deux des données binaires, utilisez application/octet-stream ou Protocol Buffers. Pas de surcoût d'encodage.

Bases de données -- stockez les données binaires dans des colonnes BLOB/BYTEA, pas en texte Base64. Le surcoût de 33% s'accumule à grande échelle.

Variant de Base64 sûr pour les URL

La Base64 standard utilise + et /, qui ont une signification spéciale dans les URL. La Base64 sûr pour les URL remplace :

Standard :  +  /  =
Sûr pour les URL :  -  _  (padding souvent omis)

Utilisé dans les JWT, les jetons OAuth et toute valeur qui voyage dans une chaîne de requête URL.

// Node.js
const encoded = Buffer.from(data).toString('base64url');

// Python
import base64
encoded = base64.urlsafe_b64encode(data).decode()

Encodage/ Décodage rapide

Utilisez l'outil Base64 pour encoder ou décoder des chaînes et vérifier que vos payloads sont corrects avant les intégrer dans les appels API.

# Commande de ligne
echo -n 'hello world' | base64
# aGVsbG8gd29ybGQ=

echo 'aGVsbG8gd29ybGQ=' | base64 --decode
# hello world

Liens connexes