Webhooki i eksport

Odbieraj zdarzenia w czasie rzeczywistym i eksportuj dane skanów w potrzebnych formatach.

Wkrótce — webhooki wychodzące nie są jeszcze dostępne. Ta strona opisuje planowany kontrakt (zdarzenia, payload, podpis), aby można było zaprojektować integrację przed premierą; szczegóły mogą się zmienić przed ogólną dostępnością.

Zdarzenia webhooków

ZDARZENIEKIEDY

scan.completedSkan kończy się powodzeniem.

score.changedWynik zmienia się względem poprzedniego skanu.

orphan.detectedWykryto nową stronę osieroconą.

scan.failedSkan kończy się błędem (wraz z jego przyczyną).

Przykładowy 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"
}

Weryfikacja podpisu

Każde żądanie będzie zawierać nagłówek X-Graphorank-Signature — podpis HMAC-SHA256 surowej treści żądania, obliczony przy użyciu sekretu podpisu. Przed przetworzeniem zdarzenia należy go zweryfikować.

Eksport

Obecnie dostępne są dwie opcje eksportu. W widoku grafu w aplikacji można zapisać bieżący widok jako PNG — przydatne w raportach i prezentacjach. Przez API GET /v1/scans/{scan_id}/graph zwraca cały graf w formacie JSON — każda strona z rolą, PageRank i metrykami linków oraz wszystkie krawędzie — z paginacją kursorową, dzięki czemu duże witryny są przesyłane sprawnie strumieniowo. Eksport CSV i raporty PDF white-label (plan Agency) są w planach. Szczegóły endpointu: dokumentacja API