Webhook ed export

Ricevi eventi in tempo reale ed esporta i dati delle tue scansioni nei formati di cui hai bisogno.

Prossimamente — i webhook in uscita non sono ancora attivi. Questa pagina documenta il contratto pianificato (eventi, payload, firma) così puoi progettare la tua integrazione prima del rilascio; i dettagli potrebbero cambiare prima della disponibilità generale.

Eventi webhook

EVENTOQUANDO

scan.completedUna scansione si conclude con successo.

score.changedIl punteggio cambia rispetto alla scansione precedente.

orphan.detectedViene rilevata una nuova pagina orfana.

scan.failedUna scansione fallisce (con il motivo).

Payload di esempio

JSON

{
  "event": "score.changed",
  "site": "rovere-arredamenti.com",
  "scan_id": "scn_12",
  "score": 68,
  "previous": 64,
  "delta": 4,
  "at": "2026-07-03T09:43:00Z"
}

Verifica della firma

Ogni richiesta includerà l’header X-Graphorank-Signature : un HMAC-SHA256 del corpo grezzo della richiesta calcolato con il tuo signing secret. Verificalo prima di elaborare l’evento.

Export

Oggi sono disponibili due opzioni di export. Dalla vista del grafo nell’app puoi salvare il rendering attuale come PNG snapshot — comodo per report e presentazioni. Tramite l’API, GET /v1/scans/{scan_id}/graph restituisce il grafo completo come JSON — ogni pagina con il suo ruolo, PageRank e metriche dei link più tutti gli archi — paginato con un cursore così i siti di grandi dimensioni si trasferiscono senza intoppi. Consulta la Riferimento API per i dettagli dell’endpoint. L’export CSV e i report PDF white-label (piano Agency) sono nella roadmap.