Integrazione API

Cos'è

Le API del Control Panel di Tuurbo permettono ai team tecnici di gestire l'ottimizzazione dei propri siti senza aprire la dashboard. Con queste API REST puoi verificare lo stato del sito, svuotare la cache e rigenerare i Critical CSS, integrando le funzionalità di ottimizzazione di Tuurbo direttamente nei tuoi sistemi e flussi di lavoro.

L'accesso alle API è disponibile su piani dedicati: contatta il nostro team per attivarlo.

Indirizzo base e autenticazione

Tutti gli endpoint sono sotto un unico indirizzo base:

https://api.tuurbo.ai/api/v1

Ogni richiesta deve includere la tua API key nell'header x-api-key:

x-api-key: YOUR_API_KEY

Tieni la chiave riservata: chi la possiede può eseguire queste azioni sui tuoi siti. Non inserirla in codice pubblico o nel browser.

Limiti di utilizzo

Le API sono soggette a rate limiting per garantire le prestazioni:

• Limite generale: 50 richieste per intervallo (l'intervallo è indicato negli header di risposta)
• Critical CSS: massimo 3 rigenerazioni al giorno per sito

Le risposte includono gli header sul rate limiting:

• X-RateLimit-Limit: numero massimo di richieste consentite
• X-RateLimit-Remaining: richieste rimanenti nell'intervallo corrente

Endpoint disponibili

1. Validazione del sito

Restituisce lo stato attuale del tuo sito in Tuurbo, inclusi i dettagli sui Critical CSS.

GET /websites/control-panel/validate

Nessun parametro richiesto. Esempio di risposta (200 OK):

{
  "websiteId": 139,
  "rootDomain": "example.com",
  "criticalLastUpdate": "2024-12-03T15:48:14.058+01:00",
  "criticalAttempts": 0,
  "maxCriticalAttempts": 3,
  "remainingCriticalAttempts": 3
}

2. Svuotamento della cache

Svuota la cache di Tuurbo per il tuo sito, forzando Tuurbo a recuperare una nuova versione dei file dal tuo server web.

GET /websites/control-panel/purge-cache

Nessun parametro richiesto. Esempio di risposta (200 OK):

{
  "success": true,
  "message": "Cache purged successfully"
}

Note:

• Svuotare la cache può ridurre temporaneamente le prestazioni del sito, perché Tuurbo deve ricaricare i file dal server di origine.
• Il server di origine può subire un aumento temporaneo del carico durante questo processo.

3. Reset dei Critical CSS

Ripristina e rigenera i Critical CSS del tuo sito. I Critical CSS sono fogli di stile ottimizzati che migliorano il tempo di caricamento della pagina.

GET /websites/control-panel/reset-critical-css

Nessun parametro richiesto. Esempio di risposta (200 OK):

{
  "success": true,
  "message": "Critical CSS reset successfully",
  "attempts": 1,
  "maxAttempts": 3,
  "lastReset": "2025-04-17"
}

Note:

• La rigenerazione dei Critical CSS è limitata a 3 tentativi al giorno per sito.
• Il reset può ridurre temporaneamente le prestazioni mentre Tuurbo analizza e genera i nuovi CSS ottimizzati.

Codici di errore

Le API restituiscono codici di stato HTTP standard:

Esempi

cURL

# Validazione del sito
curl -X GET "https://api.tuurbo.ai/api/v1/websites/control-panel/validate" \
     -H "x-api-key: YOUR_API_KEY"

# Svuotamento della cache
curl -X GET "https://api.tuurbo.ai/api/v1/websites/control-panel/purge-cache" \
     -H "x-api-key: YOUR_API_KEY"

# Reset dei Critical CSS
curl -X GET "https://api.tuurbo.ai/api/v1/websites/control-panel/reset-critical-css" \
     -H "x-api-key: YOUR_API_KEY"

JavaScript

fetch('https://api.tuurbo.ai/api/v1/websites/control-panel/validate', {
  method: 'GET',
  headers: { 'x-api-key': 'YOUR_API_KEY' }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Buone pratiche

• Uso responsabile: resetta i Critical CSS solo quando necessario, ad esempio dopo modifiche significative al design del sito.
• Monitoraggio: controlla sempre i tentativi rimanenti prima di un reset dei Critical CSS, per non raggiungere il limite giornaliero in una situazione critica.
• Svuotamento cache: usalo con moderazione, solo quando necessario, perché può aumentare temporaneamente il carico sul server di origine.
• Automazione: puoi automatizzare queste chiamate e integrarle nei tuoi flussi di deploy o manutenzione del sito.

Pagine correlate

• Caching
• Automazioni
• Contatti