Webhooks et export

Recevez les événements en temps réel et exportez les données de vos scans dans les formats dont vous avez besoin.

Bientôt disponible — les webhooks sortants ne sont pas encore actifs. Cette page documente le contrat prévu (événements, payload, signature) pour que vous puissiez concevoir votre intégration avant la sortie ; les détails peuvent évoluer avant la disponibilité générale.

Événements webhook

ÉVÉNEMENTQUAND

scan.completedUn scan se termine avec succès.

score.changedLe score change par rapport au scan précédent.

orphan.detectedUne nouvelle page orpheline est détectée.

scan.failedUn scan échoue (avec la raison).

Exemple de payload

JSON

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

Vérification de la signature

Chaque requête inclura l'en-tête X-Graphorank-Signature  : un HMAC-SHA256 du corps brut de la requête, calculé avec votre secret de signature. Vérifiez-le avant de traiter l'événement.

Export

Deux options d'export sont disponibles aujourd'hui. Depuis la vue graphe de l'application, vous pouvez enregistrer l'affichage courant en tant qu'instantané PNG — pratique pour les rapports et les présentations. Via l'API, GET /v1/scans/{scan_id}/graph renvoie le graphe complet au format JSON — chaque page avec son rôle, son PageRank et ses métriques de liens, plus toutes les arêtes — paginé par curseur pour que les grands sites soient diffusés sans accroc. Consultez la Référence API pour le détail de l'endpoint. L'export CSV et les rapports PDF en marque blanche (offre Agency) sont sur la feuille de route.