Base64 nei payload API: pro, contro e costi generali

Base64 nei Payload delle API: Pro, Contro e Overhead

Base64 codifica dati binari arbitrari come testo ASCII stampabile. È ovunque nello sviluppo web, ma spesso viene utilizzato dove non dovrebbe. Ecco quando usarlo, quando evitarlo e quanto costa effettivamente.

Come Funziona Base64

Base64 prende ogni 3 byte di input e li codifica come 4 caratteri ASCII da un alfabeto di 64 caratteri (A-Z, a-z, 0-9, +, /). Aggiunge padding con = quando l'input non è un multiplo di 3.

Input:   3 byte  →  4 caratteri
Rapporto:   aumento di dimensione del 33%
1 MB binario  →  ~1.33 MB testo Base64

Questo overhead del 33% è il prezzo della compatibilità ASCII.

Quando Usare Base64

Incorporare immagini in JSON

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

JSON non può contenere dati binari raw. Base64 è l'unica opzione per i dati binari inline.

Allegati email (MIME)

SMTP è un protocollo di testo. Ogni allegato è codificato in Base64 nel corpo MIME.

Data URI in CSS/HTML

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

Piccole icone (< 2KB) come data URI salvano una richiesta HTTP.

Payload JWT

L'header e il payload di un JWT sono JSON codificati in Base64url. Ciò consente il trasporto sicuro in URL, header e cookie.

Quando NON Usare Base64

File di grandi dimensioni -- un'immagine da 10 MB diventa 13.3 MB come testo Base64. Utilizzare multipart/form-data per il caricamento di file:

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

Quando controlli entrambe le estremità -- se il tuo client API e il server gestiscono entrambi i binari, utilizza application/octet-stream o Protocol Buffers. Nessun overhead di codifica.

Database -- memorizza i binari nelle colonne BLOB/BYTEA, non nel testo Base64. L'overhead del 33% si accumula su larga scala.

Variante Base64 URL-Safe

Base64 standard utilizza + e /, che hanno un significato speciale negli URL. Base64 URL-safe sostituisce:

Standard:  +  /  =
URL-safe:  -  _  (il padding è spesso omesso)

Utilizzato in JWT, token OAuth e qualsiasi valore che viaggia in una stringa di query URL.

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

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

Codifica/Decodifica Rapida

Utilizza lo strumento Base64 per codificare o decodificare stringhe e verificare che i tuoi payload siano corretti prima di integrarli nelle chiamate API.

# Riga di comando
echo -n 'hello world' | base64
# aGVsbG8gd29ybGQ=

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

Correlati