Skip to content
smallPict
Bắt Đầu Miễn Phí

Kiểm thử trong chế độ Sandbox

Cách sử dụng khóa thử nghiệm logic sp_test_, kiểm thử không tiêu tốn hạn ngạch và mô phỏng các trạng thái lỗi.

SmallPict tích hợp một Môi trường Sandbox Logic độc lập được thiết kế cho việc phát triển cục bộ, các đường ống kiểm thử tự động CI/CD và môi trường staging.

Chế độ Sandbox cho phép bạn thực hiện các yêu cầu tối ưu hóa hình ảnh mà hoàn toàn không bị trừ hạn ngạch hàng tháng và không có nguy cơ làm ảnh hưởng đến dữ liệu thực tế.

Lấy khóa API Sandbox

  1. Truy cập vào Bảng điều khiển SmallPict → API Keys.
  2. Nhấp vào Create Sandbox Key.
  3. Khóa của bạn sẽ được tạo với tiền tố sp_test_... (ví dụ: sp_test_9a8b7c6d5e4f...).
  4. Lưu trữ Secret Key đi kèm ở nơi an toàn.

Các rào chắn bảo vệ kiến trúc Sandbox

Khi một yêu cầu API được gửi kèm khóa sp_test_...:

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

  1. Khấu trừ hạn ngạch 0%: Dịch vụ hạn ngạch sẽ bỏ qua việc trừ dung lượng, do đó việc kiểm thử không bao giờ làm lãng phí chi phí của bạn.
  2. Lưu trữ tạm thời (24 giờ): Các hình ảnh kiểm thử được lưu trong bộ nhớ xử lý tạm thời, được mã hóa và tách biệt với môi trường production, rồi tự động bị xóa sau 24 giờ.
  3. Đánh dấu tiêu đề phản hồi: Mọi phản hồi từ các yêu cầu sandbox đều chứa tiêu đề HTTP X-SmallPict-Sandbox: true.
  4. Giới hạn tệp kiểm thử: Chế độ sandbox cho phép kiểm thử các tệp hình ảnh có dung lượng lên đến 25MB.

Ví dụ sử dụng SDK trong môi trường Sandbox

Node.js

TypeScript
import { SmallPict } from '@smallpict/sdk';import fs from 'node:fs';
const sandboxClient = new SmallPict({  apiKey: 'sp_test_1234567890abcdef...',  secretKey: 'sec_test_secret123...'});
const result = await sandboxClient.optimize(fs.readFileSync('sample.jpg'), {  format: 'avif',  quality: 80});
console.log('Chuyển đổi Sandbox thành công:', result.url);

cURL

Shell
curl -X POST https://api.smallpict.app/v1/optimize \  -H "X-API-Key: sp_test_1234567890abcdef..." \  -H "X-Timestamp: 1716301234" \  -H "X-Signature: 3a9f8b2c4d6e..." \  -H "Content-Type: application/json" \  -d {  "filename": "sample.jpg",  "mime_type": "image/jpeg",  "filesize": 500000,  "options": {    "format": "webp",    "quality": 80  }}'