Guia do ambiente Sandbox
Desenvolvimento local, testes automatizados e pipelines de CI/CD sem consumo de cotas.
O ambiente Sandbox do SmallPict permite simular o fluxo de produção completo sem cobranças ou impacto na cota mensal.
Chaves de API para Sandbox
Utilize chaves com o prefixo sp_test_:
# Chave de produção (consome cota mensal)sp_live_9a8b7c6d5e4f...
# Chave Sandbox (gratuita, sem consumo)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
Exemplo em 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("Status do teste:", result.status); // "completed" console.log("Economia obtida:", result.savingsPercentage); // ~85% console.log("URL de teste:", result.url);}
runIntegrationTest();Regras do Sandbox
- Cota zero: Requisições retornam o cabeçalho
X-Sandbox-Mode: truesem dedução de saldo. - Retenção de 24 horas: Os arquivos gerados são excluídos automaticamente após 24 horas.
- Limite de requisições: Até 60 chamadas por minuto por endereço IP.