Pengujian di Mode Sandbox

SmallPict menyediakan Mode Sandbox Logis yang dirancang untuk pengujian lokal, pipeline otomatisasi CI/CD, dan server staging.

Pengujian di mode sandbox berjalan dengan 0% pemotongan kuota bulanan dan tanpa risiko mengganggu data produksi.

🧪 Mendapatkan API Key Sandbox

1. Masuk ke Dashboard SmallPict → API Keys.
2. Klik Buat Sandbox Key.
3. Kunci pengujian Anda akan berawalan sp_test_... (misal sp_test_9a8b7c6d5e4f...).
4. Simpan pasangan secret key Anda dengan aman.

⚙️ Karakteristik Mode Sandbox

flowchart LR
    Client[Aplikasi Lokal / Unit Test] -->|X-API-Key: sp_test_...| API[SmallPict API]
    API -->|Deteksi Prefix sp_test_| Check{IsSandbox?}
    Check -->|Ya| Quota[Bypass Kuota Bulanan (0 Byte Dipotong)]
    Check -->|Ya| S3[(S3 Ephemeral: Auto-Hapus dalam 24 Jam)]
    API -->|Header Respons| Res[X-SmallPict-Sandbox: true]

1. Bypass Kuota: Pemanggilan fungsi optimasi tidak akan mengurangi jatah kuota akun Anda.
2. Penyimpanan S3 Sementara (TTL 24 Jam): File hasil uji coba disimpan pada direktori terpisah sandbox/{customer_id}/{job_id}/ dan dihapus otomatis setelah 24 jam.
3. Header Respons Identifikasi: Setiap respons dari sandbox menyertakan header X-SmallPict-Sandbox: true.
4. Batas Ukuran: Mengizinkan pengujian file hingga 25MB.

💻 Contoh Penggunaan Sandbox

Node.js

import { SmallPict } from '@smallpict/sdk';
import fs from 'node:fs';

const sandboxClient = new SmallPict({
  apiKey: 'sp_test_1234567890abcdef...',
  secretKey: 'sec_test_secret123...'
});

const result = await sandboxClient.optimize(fs.readFileSync('sample.jpg'), {
  format: 'avif',
  quality: 80
});

console.log('Hasil konversi sandbox:', result.url);