Guida di avvio rapido

Ottimizza le tue risorse visive e migliora i parametri Core Web Vitals (LCP e CLS) in soli 4 passaggi.

Guida all'avvio in 4 passaggi

Passaggio 1: Ottieni la tua chiave API

Accedi alla Dashboard di SmallPict tramite autenticazione senza password con OTP via email. Nella sezione API Keys, genera una nuova chiave:

• Usa sp_live_... per i carichi di produzione.
• Usa sp_test_... per i test locali e le pipeline di test CI/CD.

Passaggio 2: Scegli il metodo di integrazione

Opzione A: WordPress

Installa il plugin ufficiale dal repository di WordPress o carica il file ZIP. Inserisci la tua chiave sp_wp_... in Impostazioni > SmallPict e attiva la conversione automatica in WebP/AVIF.

Opzione B: SDK Backend o Frontend

Installa la libreria nativa per il tuo linguaggio di programmazione:

# Node.js & TypeScriptnpm install @smallpict/sdk
# Golanggo get github.com/smallpict/smallpict-go
# Pythonpip install smallpict
# PHP (Composer)composer require smallpict/smallpict-php
# Rust (Cargo)cargo add smallpict
# Ruby (Bundler)gem install smallpict

Passaggio 3: Esegui la prima ottimizzazione

Invia una richiesta cURL per verificare la validità della tua chiave API:

curl -X POST https://api.smallpict.app/v1/optimize \  -H "X-API-Key: sp_sdk_9a8b7c6d5e4f..." \  -H "X-Timestamp: 1716301234" \  -H "X-Signature: 3a9f8b2c4d6e8a..." \  -H "Content-Type: application/json" \  -d {  "filename": "hero.jpg",  "mime_type": "image/jpeg",  "filesize": 2508800,  "options": {    "format": "avif",    "quality": 80,    "max_width": 1920  }}'

Passaggio 4: Verifica il risultato

L'API risponderà con un oggetto JSON contenente l'URL dell'immagine ottimizzata e la percentuale di risparmio:

{  "success": true,  "data": {    "job_id": "job_9a8b7c6d5e4f",    "status": "completed",    "original_size": 2508800,    "optimized_size": 312400,    "savings_percentage": 87.54,    "format": "avif",    "url": "https://cdn.smallpict.app/media/hero.avif"  }}

Parametri di configurazione consigliati