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_ :
# 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.
- 01
Client Application
WordPress / SDK / API
Uploads raw image binary with HMAC-SHA256 signature and UUID v4 idempotency key.
Origin Request
- 02
smallPict Edge CDN
Global Edge PoPs
Checks global edge cache. On cache HIT, delivers AVIF/WebP in <20ms worldwide.
Cache & Delivery
- 03
SmallPict API Gateway
Authentication & Quotas
Validates HMAC credentials, verifies quota limits, and scopes access to customer_id.
Auth & Scoping
- 04
Optimization Engine
High-Speed Native Encoder
Multi-threaded quantization transcode to AVIF & WebP with no visible quality loss and much smaller files.
Transcoding
- 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
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
- Zéro débit de quota : Les réponses comportent l'en-tête
X-Sandbox-Mode: true. - Rétention de 24 heures : Les fichiers générés sont automatiquement effacés au bout de 24h.
- Limite de fréquence : Jusqu'à 60 requêtes par minute par adresse IP.