Skip to content
smallPict
Empezar Gratis

Guía del entorno Sandbox

Desarrollo local, pruebas automatizadas y pipelines de CI/CD con cuota ilimitada sin costo.

El entorno Sandbox de SmallPict permite a los desarrolladores simular completamente el pipeline de producción sin incurrir en costos ni consumir la cuota de producción mensual.

Claves de API para Sandbox

Para interactuar con el sandbox, utiliza cualquier clave de API con el prefijo sp_test_:

Shell
# Clave de producción (consume cuota mensual)sp_live_9a8b7c6d5e4f...
# Clave de Sandbox (gratuita, sin consumo de cuota)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

Ejemplo de uso en Node.js / TypeScript

TypeScript
import { SmallPictClient } from "@smallpict/sdk";
// Inicializa el cliente con la clave de pruebas de Sandboxconst 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("Estado de la prueba:", result.status); // "completed"  console.log("Porcentaje de ahorro:", result.savingsPercentage); // ~85%  console.log("URL de prueba generada:", result.url);}
runIntegrationTest();

Reglas del entorno Sandbox

  1. Cuota cero: Las llamadas realizadas con sp_test_... devuelven cabeceras de respuesta X-Sandbox-Mode: true y no descuentan créditos.
  2. Retención de archivos por 24 horas: Las URLs generadas en el sandbox tienen un ciclo de vida de almacenamiento de 24 horas, tras el cual se eliminan automáticamente para mantener la higiene de datos.
  3. Límite de velocidad (Rate Limit): Hasta 60 solicitudes por minuto por dirección IP para prevenir abusos en entornos de prueba.