Arsitektur & Standar SDK Resmi

Prinsip desain terpadu, jaminan keamanan, dan ketahanan jaringan di seluruh 7 SDK resmi SmallPict.

Arsitektur & Standar SDK Resmi

SmallPict menyediakan 7 SDK resmi yang dibangun dengan standar arsitektur terpadu di berbagai bahasa pemrograman modern.

🏛️ Antarmuka Terpadu 4 Metode Utama

Setiap SDK resmi mengimplementasikan 4 operasi utama yang sama:

Metode	Deskripsi
`optimize(source, options)`	Mengompresi dan mengonversi format gambar (AVIF, WebP, JPEG, PNG).
`getQuota()`	Mengambil informasi pemakaian kuota dan metrik bandwidth CDN.
`purgeCdn(urls, purgeType)`	Membersihkan cache CDN edge global secara instan.
`validateKey()`	Melakukan pengecekan kesehatan kredensial tanpa efek samping.
Helper: `getJobStatus(jobId)`	Memantau status proses konversi asinkron.

🛡️ Masking Kredensial Zero-Leak

Seluruh SDK mengimplementasikan penyamaran kredensial otomatis menggunakan regex. Kunci rahasia (sec_...) dan API key (sp_live_...) tidak pernah ditampilkan dalam bentuk teks polos pada log aplikasi atau stack trace error:

TEXT

Log: "Request failed for key sp_live_9a8b...c4d3 and secret ***REDACTED***"

🔄 Ketahanan Jaringan & Idempotensi

Exponential Backoff dengan Jitter: Saat menerima error HTTP 429 atau 5xx, SDK secara cerdas melakukan retry otomatis hingga 3 kali dengan jeda waktu eksponensial.
Idempotency Key Otomatis (UUID v4): Setiap request mutasi otomatis menyertakan header idempotency unik agar retry jaringan tidak menimbulkan duplikasi tagihan.
Mode Fallback: Mendukung mode throw (melempar exception) dan passthrough (mengembalikan buffer asli jika kuota habis agar website tetap berjalan normal).