Base64 у корисних навантаженнях API: плюси, мінуси та витрати

Base64 у API Payloads: Переваги, Недоліки та Нарахування

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

{
  "аватар": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
}

JSON не може містити рідкісні бінарні дані. Base64 є єдиним варіантом для вбудованих бінарних даних.

Прикріплення до електронних листів (MIME)

SMTP — текстовий протокол. Кожне прикріплення кодується Base64 у тілі повідомлення MIME.

Дані URIs у CSS/HTML

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

Малі іконки (< 2KB) як дані URIs економлять запит HTTP.

Повантаження JWT

Голова та вміст JWT кодуються Base64url-кодовані JSON. Це дозволяє безпечно транспортувати у URL, заголовках та куках.

Коли НЕ використовувати 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-Захищений варіант Base64

Стандартний Base64 використовує + та /, які мають особливе значення у URL. URL-Захищений Base64 заміщує:

Стандартний:  +  /  =
URL-Захищений:  -  _  (підкріплення часто відсутнє)

Використовується у JWT, OAuth-токенах та будь-якій вартості, яка здійснює поїздку у запит URL.

// 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

Пов'язані