Base64 в полезных нагрузках API: плюсы, минусы и накладные расходы

Base64 в API: плюсы, минусы и накладные расходы

Base64 кодирует произвольные бинарные данные в печатный ASCII-текст. Используется повсеместно в веб-разработке -- но часто там, где не нужен. Разбираемся, когда применять, когда избегать и во сколько это обходится.

Как работает Base64

Base64 берёт каждые 3 байта входных данных и кодирует их в 4 ASCII-символа из 64-символьного алфавита (A-Z, a-z, 0-9, +, /). Дополнение = при входе не кратном 3.

Вход:    3 байта  →  4 символа
Рост:    33% увеличение размера
1 МБ бинарных  →  ~1.33 МБ Base64-текста

33% накладных расходов -- цена совместимости с ASCII.

Когда использовать Base64

Встраивание изображений в JSON

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

JSON не может содержать сырые бинарные данные. Base64 -- единственный вариант для инлайн-бинарников.

Вложения email (MIME)

SMTP -- текстовый протокол. Каждое вложение кодируется в Base64 в теле MIME.

Data URI в CSS/HTML

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

Маленькие иконки (< 2 КБ) в data URI экономят HTTP-запрос.

JWT-пейлоады

Заголовок и полезная нагрузка JWT кодируются в Base64url. Это обеспечивает безопасную передачу в URL, заголовках и cookies.

Когда НЕ использовать Base64

Большие файлы -- изображение 10 МБ превращается в 13.3 МБ Base64-текста. Используйте multipart/form-data для загрузки файлов:

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

Когда контролируете оба конца -- если ваш API-клиент и сервер оба работают с бинарными данными, используйте application/octet-stream или Protocol Buffers. Никаких накладных расходов на кодирование.

Базы данных -- храните бинарные данные в BLOB/BYTEA-колонках, а не как Base64-текст. 33% оверхед накапливается на масштабе.

URL-Safe вариант Base64

Стандартный Base64 использует + и /, которые имеют специальное значение в URL. URL-safe Base64 заменяет:

Стандартный:  +  /  =
URL-safe:     -  _  (padding часто опускается)

Используется в JWT, OAuth-токенах и любых значениях, передаваемых в URL query string.

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

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

Быстрое кодирование/декодирование

Используйте Base64 инструмент для кодирования или декодирования строк и проверки пейлоадов перед интеграцией в API-вызовы.

# Командная строка
echo -n 'hello world' | base64
# aGVsbG8gd29ybGQ=

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

Связанные материалы