API Yüklerinde Base64: Artıları, Eksileri ve Ek Yük

Base64 in API Payloads: Pros, Cons, and Overhead

Base64, her türlü ikili veriyi yazdırılabilir ASCII metni olarak kodlar. Web geliştiriminde her yerde kullanılır -- ancak sıklıkla kullanılmaması gereken yerlerde kullanılır. Kullanılması gereken zamanlar, kullanılmaması gereken zamanlar ve gerçek maliyeti burada anlatılıyor.

How Base64 Works

Base64, her 3 bayt giriş verisini 64 karakterli bir alfabeden (A-Z, a-z, 0-9, +, /) 4 ASCII karakteri olarak kodlar. Giriş 3'ün katı değilse = ile doldurulur.

Input:   3 bytes  →  4 characters
Ratio:   33% size increase
1 MB binary  →  ~1.33 MB Base64 text

Bu 33% fazlalık, ASCII uyumluluğunun bedelidir.

When to Use Base64

Embedding images in JSON

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

JSON, ham ikili veriyi içeremez. İkili verinin satır içi kullanılması için Base64, tek seçenek olup, JSON'da ikili veri kullanmak için gerekli olan tek yöntemdir.

Email attachments (MIME)

SMTP, bir metin protokolüdür. Her ek, MIME gövdesinde Base64 kodlanır.

Data URIs in CSS/HTML

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

Küçük ikonlar (< 2KB) data URI olarak kullanılınca bir HTTP isteği tasarrufu sağlanır.

JWT payloads

JWT'nin başlığı ve yükü, Base64url kodlanmış JSON'dır. Bu, URL'ler, başlıklar ve çerezlerde güvenli taşıma imkanı sağlar.

When NOT to Use Base64

Large files -- 10 MB'lık bir resim, Base64 metni olarak 13.3 MB'ya çıkar. Dosya yüklemleri için multipart/form-data kullanın:

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

When you control both ends -- Eğer API istemciniz ve sunucunuz ikili veriyi işlemiyorsa, application/octet-stream veya Protocol Buffers kullanın. Kodlama fazlılığı olmaz.

Databases -- İkili veriyi BLOB/BYTEA sütunlarında saklayın, Base64 metni olarak değil. 33% fazlılık ölçeklendirildiğinde toplam maliyeti artırır.

URL-Safe Base64 Variant

Standart Base64, + ve / kullanır, bu karakterler URL'de özel anlamlara sahiptir. URL-safe Base64, bunları şu şekilde değiştirir:

Standard:  +  /  =
URL-safe:  -  _  (padding often omitted)

JWT'lerde, OAuth token'larında ve URL sorgu dizgesinde taşınan her değerde kullanılır.

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

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

Quick Encode/Decode

Base64 tool kullanarak dizeleri kodlayın veya çözün ve API çağrılarına entegre etmeden önce payload'larınızın doğru olduğunu doğrulayın.

# Command line
echo -n 'hello world' | base64
# aGVsbG8gd29ybGQ=

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

Related