Base64 w ładunkach API: zalety, wady i koszty ogólne

Kodowanie Base64 w ładunkach API: zalety, wady i nadmiarowość

Kodowanie Base64 przekształca dowolne dane binarne w drukowalny tekst ASCII. Jest ono wszędzie w rozwoju sieciowym -- ale często używane tam, gdzie nie powinno być. Oto kiedy go użyć, kiedy go uniknąć i jaki jest jego rzeczywisty koszt.

Jak działa Base64

Base64 pobiera każde 3 bajty danych wejściowych i koduje je jako 4 znaki ASCII z 64-znakowego alfabetu (A-Z, a-z, 0-9, +, /). Wypełnienie znakiem = gdy dane wejściowe nie są wielokrotnością 3.

Wejście:   3 bajty  →  4 znaki
Stosunek:   33% zwiększenia rozmiaru
1 MB binarne  →  ~1.33 MB tekst Base64

Ten 33% narzut jest ceną za zgodność z ASCII.

Kiedy używać Base64

Osadzanie obrazów w JSON

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

JSON nie może zawierać surowych danych binarnych. Base64 jest jedyną opcją dla osadzonych danych binarnych.

Załączniki e-mail (MIME)

SMTP jest protokołem tekstowym. Każdy załącznik jest kodowany Base64 w treści MIME.

Adresy URL danych w CSS/HTML

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

Małe ikony (< 2KB) jako adresy URL danych oszczędzają żądanie HTTP.

Ładunki JWT

Nagłówek i ładunek JWT są kodowane Base64url jako JSON. Umożliwia to bezpieczny transport w adresach URL, nagłówkach i ciasteczkach.

Kiedy NIE używać Base64

Duże pliki -- obraz 10 MB staje się 13,3 MB jako tekst Base64. Użyj multipart/form-data do przesyłania plików:

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

Gdy kontrolujesz oba końce -- jeśli klient API i serwer obsługują dane binarne, użyj application/octet-stream lub buforów protokołu. Brak nadmiaru kodowania.

Bazy danych -- przechowuj dane binarne w kolumnach BLOB/BYTEA, a nie tekst Base64. 33% narzut kumuluje się w skali.

Wariant Base64 bezpieczny dla adresów URL

Standardowe Base64 używa + i /, które mają specjalne znaczenie w adresach URL. Base64 bezpieczny dla adresów URL zastępuje:

Standard:  +  /  =
URL-safe:  -  _  (wypełnienie często pomijane)

Używany w JWT, tokenach OAuth i dowolnej wartości, która przemieszcza się w ciągu zapytania adresu URL.

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

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

Szybkie kodowanie/ dekodowanie

Użyj narzędzia Base64 do kodowania lub dekodowania ciągów i weryfikacji ładunków przed integracją ich z wywołaniami API.

# Linia poleceń
echo -n 'hello world' | base64
# aGVsbG8gd29ybGQ=

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

Powiązane