Quickstart API

Questa quickstart copre l'essenziale: autenticazione, generazione del tuo primo report e lettura della risposta. La documentazione tecnica completa con ogni endpoint è disponibile all'interno del tuo account.

Introduzione

L'API InspectWP ti permette di analizzare in modo programmatico siti web WordPress e recuperare report dettagliati su plugin, temi, sicurezza, SEO, prestazioni e altro.

Formato della risposta

Tutte le risposte API seguono un formato di envelope JSON coerente:

Risposta di successo

{
  "success": true,
  "data": { ... },
  "meta": { ... }
}

Risposta di errore

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Description",
    "status": 400
  }
}

Autenticazione

Tutte le richieste API richiedono un Bearer token nell'header Authorization. I token hanno il prefisso iwp_ e sono validi per 365 giorni.

Crea il tuo token API nella Dashboard API.

Header di esempio

Authorization: Bearer iwp_your_api_token_here

Errori di autenticazione

Se il token manca o non è valido, l'API restituisce una risposta 401 Unauthorized:

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API token. Provide a valid Bearer token in the Authorization header.",
    "status": 401
  }
}

Guida rapida

Crea un token API

Vai alla dashboard API e crea un nuovo token API.

Effettua la tua prima richiesta

Usa il tuo token per generare un report di analisi WordPress:

curl -X POST https://inspectwp.com/api/generate-report \
  -H "Authorization: Bearer iwp_your_token" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

const response = await fetch('https://inspectwp.com/api/generate-report', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer iwp_your_token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ url: 'https://example.com' })
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://inspectwp.com/api/generate-report',
    headers={
        'Authorization': 'Bearer iwp_your_token',
        'Content-Type': 'application/json'
    },
    json={'url': 'https://example.com'}
)

data = response.json()
print(data)

$ch = curl_init('https://inspectwp.com/api/generate-report');

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer iwp_your_token',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode(['url' => 'https://example.com'])
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

print_r($data);

Ottieni i risultati

La risposta contiene il report di analisi completo con tutte le sezioni.

La generazione del report può richiedere 20-90 secondi mentre il sito web viene analizzato in tempo reale.

Cerchi il riferimento API completo con tutti gli endpoint, i codici di errore e gli schemi di risposta? La documentazione completa è disponibile una volta effettuato l'accesso. Apri la documentazione API completa.