{"info":{"_postman_id":"cf7a471f-9a94-4284-a457-6028ab73659d","name":"Tuurbo - Control Panel API","description":"

Introduzione

Il Control Panel di Tuurbo.ai offre una serie di API RESTful che permettono agli utenti di gestire l'ottimizzazione dei propri siti web. Queste API consentono di validare lo stato del sito, svuotare la cache e aggiornare i Critical CSS.

Tuurbo.ai è una soluzione plug-and-play che ottimizza siti web in meno di 48 ore utilizzando automazioni e intelligenza artificiale. Attraverso queste API, è possibile integrare le funzionalità di ottimizzazione di Tuurbo.ai direttamente nei tuoi sistemi e flussi di lavoro.

Autenticazione

Tutte le chiamate API richiedono l'autenticazione mediante un API key. L'API key deve essere inclusa in ogni richiesta nell'header x-api-key.

Esempio:

x-api-key: 68e4e9aa814233669faf5684bd2e93fb\n\n

Endpoint Base

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

Rate Limiting

Le API sono soggette a rate limiting per garantire prestazioni ottimali. I limiti sono i seguenti:

Rate limit generale: 50 richieste per intervallo (indicato negli header di risposta)
\n
Critical CSS: massimo 3 aggiornamenti al giorno
\n

Gli header di risposta includeranno informazioni sul rate limiting:

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

Endpoint Disponibili

1. Validazione Sito Web

Questo endpoint restituisce informazioni sullo stato attuale del tuo sito web in Tuurbo.ai, inclusi i dettagli sul Critical CSS.

Richiesta:

GET /websites/control-panel/validate\n\n

Parametri:
Nessun parametro richiesto.

Risposta di Successo (200 OK):

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

Descrizione dei campi:

websiteId: ID univoco del sito web nel sistema Tuurbo.ai
\n
rootDomain: Dominio principale del sito web
\n
criticalLastUpdate: Data e ora dell'ultimo aggiornamento dei Critical CSS
\n
criticalAttempts: Numero di aggiornamenti dei Critical CSS eseguiti oggi
\n
maxCriticalAttempts: Numero massimo di aggiornamenti dei Critical CSS consentiti al giorno
\n
remainingCriticalAttempts: Numero di aggiornamenti dei Critical CSS rimanenti per oggi
\n

2. Svuotamento Cache

Questo endpoint consente di svuotare la cache di Tuurbo.ai per il tuo sito web. La pulizia della cache forza Tuurbo.ai a recuperare una nuova versione dei file dal tuo server web.

Richiesta:

GET /websites/control-panel/purge-cache\n\n

Parametri:
Nessun parametro richiesto.

Risposta di Successo (200 OK):

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

Note:

La pulizia della cache potrebbe temporaneamente diminuire le prestazioni del tuo sito web, poiché Tuurbo.ai dovrà ricaricare i file dal server di origine.
\n
Potrebbe verificarsi un aumento temporaneo del carico sul server di origine durante questo processo.
\n

3. Reset Critical CSS

Questo endpoint consente di ripristinare e rigenerare i Critical CSS per il tuo sito web. I Critical CSS sono fogli di stile ottimizzati che migliorano il tempo di caricamento della pagina.

Richiesta:

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

Parametri:
Nessun parametro richiesto.

Risposta di Successo (200 OK):

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

Descrizione dei campi:

success: Indica se l'operazione è andata a buon fine
\n
message: Messaggio descrittivo dell'esito dell'operazione
\n
attempts: Numero di aggiornamenti dei Critical CSS eseguiti oggi (incluso questo)
\n
maxAttempts: Numero massimo di aggiornamenti dei Critical CSS consentiti al giorno
\n
lastReset: Data dell'ultimo reset
\n

Note:

L'aggiornamento dei Critical CSS è limitato a 3 tentativi al giorno per sito web.
\n
Il reset dei Critical CSS potrebbe temporaneamente diminuire le prestazioni del tuo sito web mentre Tuurbo.ai analizza e genera nuovi CSS ottimizzati.
\n

Codici di Errore

Le API restituiscono codici di stato HTTP standard:

200 OK: La richiesta è stata elaborata con successo
\n
401 Unauthorized: API key mancante o non valida
\n
403 Forbidden: L'API key non ha i permessi necessari
\n
429 Too Many Requests: Superato il limite di richieste (rate limit)
\n
500 Internal Server Error: Errore interno del server
\n

Esempi di Utilizzo

Esempio in cURL

# Validazione sito\ncurl -X GET \"https://api.tuurbo.ai/api/v1/websites/control-panel/validate\" \\\n     -H \"x-api-key: YOUR_API_KEY\"\n# Svuotamento cache\ncurl -X GET \"https://api.tuurbo.ai/api/v1/websites/control-panel/purge-cache\" \\\n     -H \"x-api-key: YOUR_API_KEY\"\n# Reset Critical CSS\ncurl -X GET \"https://api.tuurbo.ai/api/v1/websites/control-panel/reset-critical-css\" \\\n     -H \"x-api-key: YOUR_API_KEY\"\n\n

Esempio in JavaScript

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

Best Practices

Uso Responsabile: Utilizza la funzione di reset dei Critical CSS solo quando necessario, ad esempio dopo modifiche significative al design del sito.
\n
Monitoraggio: Controlla sempre il numero di tentativi rimanenti prima di effettuare un reset dei Critical CSS, per evitare di raggiungere il limite giornaliero in situazioni critiche.
\n
Svuotamento Cache: Utilizza questa funzione con moderazione, solo quando necessario, poiché può aumentare temporaneamente il carico sul server di origine.
\n
Automazione: È possibile automatizzare queste chiamate API per integrarle nei tuoi flussi di lavoro di deployment o manutenzione del sito web.
\n

Supporto

Per assistenza o richieste di supporto, contatta il team di Tuurbo.ai all'indirizzo support@tuurbo.ai o visita https://customerportal.tuurbo.ai/

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"35336289","collectionId":"cf7a471f-9a94-4284-a457-6028ab73659d","publishedId":"2sB2iwGui5","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"020617","highlight":"3775de"},"publishDate":"2025-04-22T10:54:30.000Z"},"item":[{"name":"Control Panel - Validate","id":"ffe8e36f-8fb0-4a7a-999d-1baf81220d6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"68e4e9aa814233669faf5684bd2e93fb"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.tuurbo.ai/api/v1/websites/control-panel/validate","urlObject":{"path":["websites","control-panel","validate"],"host":["https://api.tuurbo.ai/api/v1"],"query":[],"variable":[]}},"response":[{"id":"41ddea91-c214-45ac-b640-9059bca88c64","name":"200","originalRequest":{"method":"GET","header":[],"url":"https://api.tuurbo.ai/api/v1/websites/control-panel/validate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-RateLimit-Limit","value":"50"},{"key":"X-RateLimit-Remaining","value":"49"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"171"},{"key":"ETag","value":"W/\"ab-BX/QRpdpZIMIudy/quFwQ2uT2lo\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Thu, 17 Apr 2025 10:09:35 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"websiteId\": 139,\n \"rootDomain\": \"tuurbo.org\",\n \"criticalLastUpdate\": \"2024-12-03T15:48:14.058+01:00\",\n \"criticalAttempts\": 0,\n \"maxCriticalAttempts\": 3,\n \"remainingCriticalAttempts\": 3\n}"}],"_postman_id":"ffe8e36f-8fb0-4a7a-999d-1baf81220d6d"},{"name":"Control Panel - Purge Cache","id":"a670f4fc-3514-46dd-b0e4-7b8e810f9cc8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"68e4e9aa814233669faf5684bd2e93fb"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.tuurbo.ai/api/v1/websites/control-panel/purge-cache","urlObject":{"path":["websites","control-panel","purge-cache"],"host":["https://api.tuurbo.ai/api/v1"],"query":[],"variable":[]}},"response":[{"id":"1486817b-685c-4d8c-882c-5325cfcd915b","name":"200","originalRequest":{"method":"GET","header":[],"url":"https://api.tuurbo.ai/api/v1/websites/control-panel/purge-cache"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-RateLimit-Limit","value":"50"},{"key":"X-RateLimit-Remaining","value":"47"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"54"},{"key":"ETag","value":"W/\"36-XvFRpTOtjX26iGyLHafajrrHzLE\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Thu, 17 Apr 2025 10:10:05 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Cache purged successfully\"\n}"}],"_postman_id":"a670f4fc-3514-46dd-b0e4-7b8e810f9cc8"},{"name":"Control Panel - Reset Critical CSS","id":"fdd17dbb-94b9-4c90-9e46-f833b6519d9f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"68e4e9aa814233669faf5684bd2e93fb"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.tuurbo.ai/api/v1/websites/control-panel/reset-critical-css","urlObject":{"path":["websites","control-panel","reset-critical-css"],"host":["https://api.tuurbo.ai/api/v1"],"query":[],"variable":[]}},"response":[{"id":"713f64af-cf26-4514-b51c-b9491d5c07d2","name":"200","originalRequest":{"method":"GET","header":[],"url":"https://api.tuurbo.ai/api/v1/websites/control-panel/reset-critical-css"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-RateLimit-Limit","value":"50"},{"key":"X-RateLimit-Remaining","value":"48"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"114"},{"key":"ETag","value":"W/\"72-st0HfyDeJDntNSj0xSxvFKDTgJg\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Thu, 17 Apr 2025 10:09:49 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Critical CSS reset successfully\",\n \"attempts\": 1,\n \"maxAttempts\": 3,\n \"lastReset\": \"2025-04-17\"\n}"}],"_postman_id":"fdd17dbb-94b9-4c90-9e46-f833b6519d9f"}],"event":[{"listen":"prerequest","script":{"id":"91a2a81f-0e2e-4989-a425-7dd81807ba4b","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"21ab13f4-8a7f-4e7b-9444-2a233d55712a","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"APIURL","value":"https://api.tuurbo.ai/api/v1","type":"string"},{"key":"APIKEY","value":"68e4e9aa814233669faf5684bd2e93fb","type":"string"}]}