Webhooks & export

Ontvang events in realtime en exporteer je scandata in de formaten die je nodig hebt.

Binnenkort beschikbaar — uitgaande webhooks zijn nog niet live. Deze pagina beschrijft het geplande contract (events, payload, handtekening), zodat je je integratie alvast kunt ontwerpen; details kunnen wijzigen vóór de algemene beschikbaarheid.

Webhook-events

EVENTWANNEER

scan.completedEen scan wordt succesvol afgerond.

score.changedDe score verandert ten opzichte van de vorige scan.

orphan.detectedEr wordt een nieuwe weespagina gedetecteerd.

scan.failedEen scan mislukt (met de reden).

Voorbeeldpayload

JSON

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

Verificatie van de handtekening

Elk verzoek bevat de X-Graphorank-Signature header: een HMAC-SHA256 van de ruwe request body, berekend met je signing secret. Verifieer die voordat je het event verwerkt.

Export

Er zijn nu twee exportopties. In de grafiekweergave van de app sla je de huidige weergave op als PNG snapshot — handig voor rapporten en presentaties. Via de API geeft GET /v1/scans/{scan_id}/graph de volledige grafiek terug als JSON — elke pagina met rol, PageRank en linkmetrics plus alle edges — gepagineerd met een cursor, zodat grote sites soepel streamen. Zie de API-referentie voor de details van het endpoint. CSV-export en white-label pdf-rapporten (Agency-plan) staan op de roadmap.