Skip to content
smallPict

Guide de l'environnement Sandbox

Développement local, tests automatisés et pipelines CI/CD sans consommation de quota.

L'environnement Sandbox de SmallPict permet de valider vos intégrations techniques sans impacter votre quota de production mensuel.


Clés d'API Sandbox

Utilisez simplement une clé avec le préfixe sp_test_ :

Shell
# Clé de production (débite le quota mensuel)sp_live_9a8b7c6d5e4f...
# Clé Sandbox (gratuite, aucun débit)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


Exemple en Node.js / TypeScript

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("Statut du test :", result.status); // "completed"  console.log("Économie mesurée :", result.savingsPercentage); // ~85%  console.log("URL de test :", result.url);}
runIntegrationTest();

Caractéristiques du Sandbox

  1. Zéro débit de quota : Les réponses comportent l'en-tête X-Sandbox-Mode: true.
  2. Rétention de 24 heures : Les fichiers générés sont automatiquement effacés au bout de 24h.
  3. Limite de fréquence : Jusqu'à 60 requêtes par minute par adresse IP.