Skip to content
smallPict
Ücretsiz Başla

Sandbox Ortamı Kılavuzu

Kota harcamadan yerel geliştirme, otomatik testler ve CI/CD süreçleri.

SmallPict Sandbox ortamı, geliştiricilerin aylık kotalarını harcamadan üretim hattını birebir simüle etmelerine imkan tanır.

Sandbox API Anahtarları

Test ortamı için sp_test_ önekine sahip anahtarları kullanın:

Shell
# Canlı üretim anahtarı (kullanım kotasından düşer)sp_live_9a8b7c6d5e4f...
# Sandbox test anahtarı (ücretsizdir, kota harcamaz)sp_test_1a2b3c4d5e6f...

End-to-End Image Processing & Edge CDN Flow

Sub-50ms image optimization lifecycle from client upload to global edge delivery.

  1. 01

    Client Application

    WordPress / SDK / API

    Uploads raw image binary with HMAC-SHA256 signature and UUID v4 idempotency key.

    Origin Request

  2. 02

    smallPict Edge CDN

    Global Edge PoPs

    Checks global edge cache. On cache HIT, delivers AVIF/WebP in <20ms worldwide.

    Cache & Delivery

  3. 03

    SmallPict API Gateway

    Authentication & Quotas

    Validates HMAC credentials, verifies quota limits, and scopes access to customer_id.

    Auth & Scoping

  4. 04

    Optimization Engine

    High-Speed Native Encoder

    Multi-threaded quantization transcode to AVIF & WebP with no visible quality loss and much smaller files.

    Transcoding

  5. 05

    Secure Storage & Sync

    Encrypted Cloud Storage

    Stores optimized output, invalidates outdated cache tags, and warms the edge cache.

    Persistent Sync

Zero Data Interception: End-to-end HMAC validation & SHA256 integrity check

Engine: smallPict

Node.js / TypeScript ile Kullanım

TypeScript
import { SmallPictClient } from "@smallpict/sdk";
const client = new SmallPictClient({  apiKey: process.env.SMALLPICT_TEST_KEY || "sp_test_sandbox_secret_key"});
async function runIntegrationTest() {  const result = await client.optimize({    file: "./test-fixtures/large-banner.jpg",    format: "avif",    quality: 80  });
  console.log("Test Durumu:", result.status); // "completed"  console.log("Tasarruf Oranı:", result.savingsPercentage); // ~%85  console.log("Sandbox URL'si:", result.url);}
runIntegrationTest();

Sandbox Kuralları

  1. Sıfır Kota Tüketimi: Yanıtlar X-Sandbox-Mode: true başlığını taşır ve kota eksilmez.
  2. 24 Saatlik Saklama: Oluşturulan test dosyaları 24 saat sonra otomatik olarak silinir.
  3. Hız Sınırı: IP adresi başına dakikada en fazla 60 istek.