Benachrichtigungen API

ENTWURF — Nur für interne Entwicklerteams

Diese API-Referenz ist für interne Entwicklerteams bestimmt.

Übersicht

Was es ist: Die Benachrichtigungs-API bietet Zugriff auf die verfügbaren Benachrichtigungs-Ereignistypen, die Discovery ausgeben kann. Diese Ereignisse steuern Automatisierungs-Workflows und externe Integrationen.

Endpunkte

Methode	Pfad	Beschreibung	Authentifizierung erforderlich
GET	/internal/v1/notification/events	Benachrichtigungs-Ereignistypen auflisten	JWT + API-Token

---

GET /internal/v1/notification/events

Alle verfügbaren Benachrichtigungs-Ereignistypen auflisten.

Anfrage:

GET /internal/v1/notification/events
Authorization: Bearer <token>

Antwort (200):

{
  "events": [
    {
      "type": "collection.completed",
      "description": "Fired when a data source collection run completes",
      "payload": ["dataSourceId", "entityCount", "status", "duration"]
    },
    {
      "type": "threat.detected",
      "description": "Fired when a new threat is detected for an identity",
      "payload": ["entityId", "threatScore", "ruleId", "severity"]
    },
    {
      "type": "account.discovered",
      "description": "Fired when a new account is discovered",
      "payload": ["accountId", "dataSourceId", "entityType"]
    },
    {
      "type": "certification.created",
      "description": "Fired when a new certification campaign is created",
      "payload": ["certificationId", "scope", "reviewerCount"]
    }
  ]
}