API-Dokumentation

API-Referenz

Vollständige Dokumentation für alle Public Safety-APIs einschließlich GraphQL-, REST- und WebSocket-Endpunkten. Alle Endpunkte benötigen einen gültigen argus_auth_token, um Daten zurückzugeben.

API-Übersicht

Public Safety Command Center stellt zwei primäre API-Services mit über 200 REST-Endpunkten und 180+ GraphQL-Operationen bereit. Alle authentifizierten Endpunkte benötigen einen gültigen argus_auth_token, der über den Auth-Service bezogen wird.

Auth-Service

auth.knogin.com

Verwaltet alle Authentifizierung, Benutzerverwaltung, MFA, SSO, API-Schlüssel, Rollen, Berechtigungen und Sitzungsverwaltung. Hier erhalten Sie Token für den Zugriff auf den API-Service.

  • 80+ Endpunkte
  • OAuth2/OIDC
  • TOTP/Passkey/Voice MFA

API-Service

api.knogin.com

Die zentrale Intelligence-Plattform-API mit REST-Endpunkten und GraphQL für Ermittlungen, Vorgänge, Profile, Beweise, Alarme, Monitore, KI-Services und Echtzeitkommunikation.

  • 130+ REST-Endpunkte
  • 180+ GraphQL-Operationen
  • WebSocket

Basis-URLs

Auth-Service (Produktion)https://auth.knogin.com
API-Service (Produktion)https://api.knogin.com
Auth-Service (Staging)https://auth-staging.knogin.com
API-Service (Staging)https://api-staging.knogin.com

Authentifizierung

Alle authentifizierten API-Anfragen benötigen einen gültigen argus_auth_token. Token werden über den Auth-Service bezogen und müssen in allen nachfolgenden Anfragen an beide Services enthalten sein. API-Schlüssel können im Auth-Service-Dashboard unter Ihrem Benutzerprofil für programmatischen Zugriff generiert werden.

HTTP-Only-Cookie (Empfohlen für Browser)

Nach erfolgreichem Login werden Cookies automatisch gesetzt:

Nach Login gesetzte Cookies
platform_access_token=eyJhbGc...  # Short-lived access token
knogin_refresh_token=eyJhbGc...   # Long-lived refresh token

Bearer-Token (Für programmatischen Zugriff)

Fügen Sie den Token im Authorization-Header hinzu:

Authorization-Header
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Token erhalten

Beispiel: Login mit Zugangsdaten (Auth-Service)
# Using username/password (OAuth2 form)
curl -X POST https://auth.knogin.com/v1/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "[email protected]&password=your_password"

# Using API Key (recommended for service-to-service)
curl -X POST https://auth.knogin.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"api_key": "your_api_key", "platform": "publicSafety"}'

# Response
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer",
  "expires_in": 3600
}

Auth-Service-Endpunkte

Der Auth-Service (auth.knogin.com) verwaltet alle Authentifizierung, Autorisierung, Benutzerverwaltung, MFA, SSO, API-Schlüssel, Rollen, Berechtigungen, Feature Flags und Multi-Tenant-Verwaltung. Er enthält 80+ Endpunkte, organisiert nach Funktionalität.

Token- & Sitzungsverwaltung

Zentrale Authentifizierungsendpunkte zum Erhalten, Erneuern und Verwalten von Zugriffstoken und Sitzungen.

POST
/v1/token

Login mit Zugangsdaten (OAuth2-Formular)

OAuth2-kompatibler Login-Endpunkt, der formular-kodierte E-Mail und Passwort akzeptiert. Gibt plattformspezifische Zugriffstoken aus und setzt HTTP-only-Cookies (platform_access_token, knogin_refresh_token) für Browser-Sitzungen. Vorgangs MFA aktiviert ist, wird stattdessen ein Challenge-Cookie zurückgegeben, das eine Verifizierung über /v1/mfa/verify-login erfordert. Unterstützt redirect_uri für Post-Login-Navigation.

Öffentlich5/min
POST
/v1/auth/token

Login mit API-Schlüssel

Authentifizierung mit einem API-Schlüssel zum Erhalt eines plattformspezifischen JWT-Tokens. Ideal für Service-zu-Service-Authentifizierung, CI/CD-Pipelines und programmatischen Zugriff. API-Schlüssel können im Auth-Service-Dashboard unter Ihrem Benutzerprofil generiert werden. Request-Body erfordert api_key- und platform-Felder.

Öffentlich
POST
/v1/auth/refresh

Zugriffstoken erneuern

Erneuert abgelaufene Zugriffstoken mithilfe des knogin_refresh_token-Cookies. Gibt neue Zugriffstoken-Cookies zurück, ohne erneute Authentifizierung zu erfordern. Unterstützt optionalen Plattform-Pfadparameter für plattformspezifische Token-Erneuerung. Essentiell zur Aufrechterhaltung langlebiger Sitzungen in Browser-Anwendungen.

Öffentlich
POST
/v1/auth/logout

Logout & Sitzung beenden

Beendet die aktuelle Benutzersitzung durch Invalidierung aller Token und Löschung der Authentifizierungs-Cookies. Entfernt die Sitzung aus dem serverseitigen Sitzungsspeicher. Unterstützt optionalen Plattform-Pfadparameter. Gibt 204 No Content bei Erfolg zurück.

Auth erforderlich
POST
/v1/auth/revoke-user-sessions/{user_id}

Alle Benutzersitzungen widerrufen (Admin)

Beendet zwangsweise alle aktiven Sitzungen für einen bestimmten Benutzer über alle Geräte und Plattformen hinweg. Wird bei Sicherheitsvorfällen oder wenn der Zugriff eines Benutzers sofort widerrufen werden muss, verwendet. Gibt die Anzahl widerrufener Sitzungen zurück. Erfordert Admin- oder Superuser-Rolle.

Admin/Superuser

Benutzerprofil & Self-Service

Endpunkte für Benutzer zur Verwaltung ihrer eigenen Profile, Anzeige ihrer Informationen und Aktualisierung ihrer Einstellungen.

GET
/v1/users/me

Aktuelles Benutzerprofil abrufen

Gibt das vollständige Profil des aktuell authentifizierten Benutzers zurück, einschließlich E-Mail, Anzeigename, Organisation, Rollen, Berechtigungen, MFA-Status, Erstellungsdatum und letztem Login-Zeitstempel. Wird von Frontend-Anwendungen verwendet, um Benutzer-Dashboards zu befüllen und Berechtigungen zu überprüfen.

Auth erforderlich
PUT
/v1/users/me

Eigenes Profil aktualisieren

Ermöglicht Benutzern, ihre eigenen Profilinformationen einschließlich Anzeigename, Telefonnummer und Passwort zu aktualisieren. Bei Passwortänderung werden alle anderen Sitzungen aus Sicherheitsgründen automatisch beendet. Erfordert aktuelle Passwort-Verifizierung für sensible Änderungen.

Auth erforderlich
GET
/v1/auth/me

Profil mit Feature Flags abrufen

Gibt das aktuelle Benutzerprofil zusammen mit ausgewerteten Feature Flags für den Tenant des Benutzers und benutzerspezifische Überschreibungen zurück. Wird von Frontend-Anwendungen verwendet, um zu bestimmen, welche Features basierend auf dem Abonnement-Tier des Benutzers und aktivierten Experimenten angezeigt werden sollen.

Auth erforderlich
POST
/v1/users/create

Selbstregistrierung

Öffentlicher Endpunkt für neue Benutzer zur Kontoerstellung. Akzeptiert E-Mail und Passwort, erstellt den Benutzer im System und sendet eine Verifizierungs-E-Mail. Rate-limitiert auf 2 Anfragen pro Stunde pro IP, um Missbrauch zu verhindern. Gibt das erstellte Benutzerobjekt zurück.

Öffentlich2/hour

Multi-Faktor-Authentifizierung (MFA)

Umfassende MFA-Unterstützung einschließlich TOTP (Authentifikator-Apps), WebAuthn-Passkeys und Sprachverifizierung. Benutzer können mehrere Methoden für mehrschichtige Sicherheit aktivieren.

TOTP (Authentifikator-Apps)

POST
/v1/portal/mfa/totp/enable

TOTP aktivieren - Secret generieren

Generiert ein neues TOTP-Secret und gibt es zusammen mit einem QR-Code-Bild (base64-kodiert) zum Scannen mit Authentifikator-Apps wie Google Authenticator, Authy oder 1Password zurück. Das Secret wird im Pending-Status gespeichert, bis es verifiziert wird.

Auth erforderlich
POST
/v1/portal/mfa/totp/verify-and-activate

TOTP verifizieren und aktivieren

Verifiziert einen TOTP-Code aus der Authentifikator-App des Benutzers und aktiviert TOTP-MFA für dessen Konto. Erfordert den 6-stelligen Code aus der Authentifikator-App. Nach Aktivierung wird TOTP für alle zukünftigen Logins erforderlich.

Auth erforderlich
POST
/v1/portal/mfa/totp/disable

TOTP deaktivieren

Deaktiviert TOTP-basierte MFA für den aktuellen Benutzer. Alle aktiven Sitzungen werden aus Sicherheitsgründen nach Deaktivierung beendet. Benutzer muss eine andere MFA-Methode aktiviert haben oder MFA darf nicht durch Organisationsrichtlinien erforderlich sein.

Auth erforderlich
POST
/v1/mfa/verify-login

MFA während Login verifizieren

Validiert den MFA-Code (TOTP) während des Login-Challenge-Flows. Wird nach initialem Login aufgerufen, wenn MFA erforderlich ist. Erfordert das TF_AUTH-Challenge-Cookie und den 6-stelligen TOTP-Code. Bei Erfolg werden vollständige Zugriffstoken ausgegeben.

Öffentlich5/min

WebAuthn-Passkeys

POST
/v1/portal/mfa/passkey/generate-registration

Passkey-Registrierungsoptionen generieren

Generiert WebAuthn-Registrierungsoptionen zum Erstellen neuer Passkey-Credentials. Gibt Challenge, Relying-Party-Info und unterstützte Algorithmen zurück. Wird von der WebAuthn-API des Browsers (navigator.credentials.create) zum Erstellen eines neuen Passkeys verwendet.

Auth erforderlich
POST
/v1/portal/mfa/passkey/verify-registration

Passkey verifizieren und speichern

Verifiziert die WebAuthn-Attestation-Response vom Browser und speichert den neuen Passkey-Credential. Speichert den öffentlichen Schlüssel, Credential-ID und Metadaten. Benutzer können mehrere Passkeys für verschiedene Geräte registrieren.

Auth erforderlich
DELETE
/v1/portal/mfa/passkey/{credential_id}

Passkey löschen

Entfernt einen bestimmten Passkey-Credential anhand seiner ID. Benutzer können ihre registrierten Passkeys verwalten und alte oder kompromittierte Geräte entfernen. Gibt 204 No Content bei Erfolg zurück.

Auth erforderlich
POST
/v1/portal/mfa/passkey/generate-authentication

Passkey-Login-Optionen generieren

Generiert WebAuthn-Authentifizierungsoptionen für Passkey-basierten Login. Akzeptiert E-Mail-Adresse und gibt Challenge mit erlaubten Credentials zurück. Wird von navigator.credentials.get für passwortlose Login-Initiierung verwendet.

Öffentlich
POST
/v1/portal/mfa/passkey/verify-authentication

Passkey verifizieren und einloggen

Verifiziert die WebAuthn-Assertion-Response und schließt Passkey-basierten Login ab. Bei erfolgreicher Verifizierung werden vollständige Zugriffstoken und Cookies ausgegeben. Unterstützt redirect_uri für Post-Login-Navigation.

Öffentlich

Sprachverifizierung

POST
/v1/portal/mfa/voice/enroll

Sprachprofil registrieren

Registriert eine Sprachprobe für sprachbasierte MFA. Akzeptiert base64-kodierte Audiodaten des Benutzers, der eine Passphrase spricht. Der Stimmabdruck wird verarbeitet und für zukünftige Verifizierung gespeichert. Erfordert mehrere Proben für genaue Registrierung.

Auth erforderlich
POST
/v1/portal/mfa/voice/verify

Sprachprobe verifizieren

Verifiziert eine Sprachprobe gegen das registrierte Sprachprofil während der MFA-Challenge. Akzeptiert base64-kodiertes Audio und gibt Match-Score zurück. Erfordert MFA-Challenge-Cookie. Wird als Alternative zu TOTP für Benutzer verwendet, die Sprachauthentifizierung bevorzugen.

Öffentlich5/min
DELETE
/v1/portal/mfa/voice

Sprach-MFA deaktivieren

Deaktiviert sprachbasierte MFA und löscht das gespeicherte Sprachprofil. Gibt 204 No Content bei Erfolg zurück. Benutzer muss eine andere MFA-Methode aktiviert haben, vorgangs MFA durch Organisationsrichtlinie erforderlich ist.

Auth erforderlich
GET
/v1/portal/mfa/challenge-info

Verfügbare MFA-Methoden abrufen

Gibt Informationen darüber zurück, welche MFA-Methoden für die ausstehende Login-Challenge verfügbar sind. Response enthält totp_enabled-, voice_enabled- und passkey_enabled-Flags. Wird von Login-UI verwendet, um geeignete MFA-Optionen anzuzeigen.

Öffentlich

Single Sign-On (SSO)

OAuth2/OIDC-basierte Single-Sign-On-Integration mit Enterprise-Identity-Providern einschließlich Google Workspace und Microsoft Entra ID (Azure AD).

GET
/v1/portal/sso/available-providers

Verfügbare SSO-Provider auflisten

Gibt eine Liste der für den aktuellen Tenant konfigurierten SSO-Provider zurück. Response enthält Providernamen und Anzahl. Wird von Login-UI verwendet, um verfügbare SSO-Login-Schaltflächen anzuzeigen (z.B. 'Mit Google anmelden', 'Mit Microsoft anmelden').

Öffentlich
GET
/v1/portal/login/{provider}

SSO-Login initiieren

Initiiert den OAuth2/OIDC-Autorisierungsfluss mit dem angegebenen Identity-Provider. Leitet den Benutzer zur Login-Seite des Providers (Google, Microsoft) um. Akzeptiert redirect_uri für Post-Login-Navigation.

Öffentlich
GET
/v1/portal/auth/{provider}

SSO-Callback-Handler

OAuth2/OIDC-Callback-Endpunkt, der den vom Identity-Provider zurückgegebenen Autorisierungscode verarbeitet. Tauscht Code gegen Token aus, erstellt oder aktualisiert Benutzerkonto und etabliert Sitzung mit Cookies.

Öffentlich

API-Schlüsselverwaltung

Erstellen und verwalten Sie API-Schlüssel für programmatischen Zugriff. API-Schlüssel können auf bestimmte Plattformen beschränkt und mit konfigurierbarem Ablauf versehen werden.

POST
/v1/portal/users/me/keys

API-Schlüssel erstellen

Erstellt einen neuen API-Schlüssel für programmatischen Zugriff. Der vollständige Schlüssel wird nur einmal bei Erstellung zurückgegeben - speichern Sie ihn sicher. Unterstützt Plattform-Scoping und optionales Ablaufdatum. Gibt Schlüsselpräfix zur Identifikation zurück.

Auth erforderlich
GET
/v1/portal/users/me/keys

API-Schlüssel auflisten

Gibt alle API-Schlüssel für den aktuellen Benutzer zurück. Zeigt Schlüsselpräfix, Erstellungsdatum, Datum der letzten Verwendung und zugeordnete Plattformen. Gibt aus Sicherheitsgründen nicht den vollständigen Schlüsselwert zurück.

Auth erforderlich
DELETE
/v1/portal/users/me/keys/{key_id}

API-Schlüssel widerrufen

Widerruft dauerhaft einen API-Schlüssel und invalidiert sofort alle mit diesem Schlüssel ausgestellten Token. Alle Anwendungen, die diesen Schlüssel verwenden, verlieren sofort den Zugriff. Kann nicht rückgängig gemacht werden.

Auth erforderlich

Benutzerverwaltung (Admin)

Administrative Endpunkte zur Verwaltung von Benutzern, Rollen und Berechtigungen. Der Zugriff variiert je nach Rollenhierarchie.

GET
/v1/portal/admin/users

Benutzer auflisten

Gibt alle Benutzer basierend auf der Rolle des Aufrufers zurück. Manager sehen nur Benutzer in ihrer Organisation. Superuser sehen alle Benutzer über alle Organisationen hinweg. Unterstützt Paginierung und Filterung nach Rolle, Status und Organisation.

Admin/Manager
POST
/v1/portal/admin/users

Benutzer erstellen

Erstellt einen neuen Benutzer mit angegebener E-Mail, Passwort, Rollen und Organisationszuweisung. Sendet optional Willkommens-E-Mail. Kann initialen Plattformzugriff und Sicherheitsfreigabe-Level zuweisen. Nur Superuser.

Admin/Superuser
GET
/v1/portal/admin/users/{user_id}

Benutzer nach ID abrufen

Gibt detaillierte Benutzerinformationen einschließlich Profil, Rollen, Berechtigungen, MFA-Status und Aktivitätsverlauf zurück. Manager können nur Benutzer in ihrer Organisation anzeigen.

Admin/Manager
PUT
/v1/portal/admin/users/{user_id}

Benutzer aktualisieren

Aktualisiert Benutzerdetails einschließlich Rollen, Berechtigungen, Plattformzugriff und Sicherheitsfreigabe. Kann Benutzer aktivieren/deaktivieren. Rollenänderungen werden bei nächster Token-Erneuerung wirksam. Nur Superuser für organisationsübergreifende Änderungen.

Admin/Superuser
DELETE
/v1/portal/admin/users/{user_id}

Benutzer löschen

Löscht dauerhaft ein Benutzerkonto und alle zugeordneten Daten einschließlich API-Schlüssel und Sitzungen. Diese Aktion ist unwiderruflich. Nur Superuser. Gelöschte Benutzer können nicht wiederhergestellt werden.

Admin/Superuser
PATCH
/v1/users/{user_id}/permissions

Benutzerberechtigungen aktualisieren

Aktualisiert granulare Berechtigungen eines Benutzers unabhängig von seinen rollenbasierten Berechtigungen. Ermöglicht Feinabstimmung der Zugriffskontrolle. Nur Admin oder Superuser. Gibt aktualisierte Berechtigungsmenge zurück.

Admin/Superuser

Rollen- & Berechtigungsverwaltung

Definieren Sie benutzerdefinierte Rollen und granulare Berechtigungen für fein abgestimmte Zugriffskontrolle innerhalb von Organisationen.

GET
/v1/roles

Verfügbare Rollen auflisten

Gibt alle im System verfügbaren Rollen zurück, einschließlich integrierter Rollen (Admin, Manager, Analyst, Viewer) und benutzerdefinierter Rollen für die Organisation. Enthält mit jeder Rolle verknüpfte Berechtigungen.

Öffentlich
POST
/v1/roles

Benutzerdefinierte Rolle erstellen

Erstellt eine neue benutzerdefinierte Rolle mit angegebenen Berechtigungen. Benutzerdefinierte Rollen erweitern die integrierte Rollenhierarchie. Nur Superuser. Rollennamen müssen innerhalb der Organisation eindeutig sein.

Admin/Superuser
PUT
/v1/roles/{role_id}

Rolle aktualisieren

Aktualisiert Namen, Beschreibung oder Berechtigungen einer benutzerdefinierten Rolle. Änderungen betreffen alle Benutzer mit dieser Rolle bei ihrer nächsten Token-Erneuerung. Kann integrierte Rollen nicht ändern. Nur Superuser.

Admin/Superuser
DELETE
/v1/roles/{role_id}

Benutzerdefinierte Rolle löschen

Löscht eine benutzerdefinierte Rolle. Benutzer mit dieser Rolle verlieren zugeordnete Berechtigungen. Kann keine Rollen löschen, die aktuell Benutzern zugewiesen sind. Kann integrierte Rollen nicht löschen. Nur Superuser.

Admin/Superuser

Feature Flags

Steuern Sie die Verfügbarkeit von Features auf Tenant- und Benutzerebene für schrittweise Rollouts und A/B-Tests.

GET
/v1/feature-flags/tenant

Tenant-Feature-Flags abrufen

Gibt alle Feature Flags und deren Werte für den aktuellen Tenant zurück. Dies sind die Basis-Flags, die für alle Benutzer in der Organisation gelten, sofern nicht auf Benutzerebene überschrieben.

Admin/Manager
PUT
/v1/feature-flags/tenant

Tenant-Feature-Flags aktualisieren

Aktualisiert Feature Flags für den Tenant. Änderungen gelten für alle Benutzer in der Organisation, sofern sie keine Benutzerebenen-Überschreibungen haben. Wird verwendet, um Features für die gesamte Organisation zu aktivieren/deaktivieren.

Admin/Manager
GET
/v1/feature-flags/user/{user_id}

Benutzer-Feature-Flag-Überschreibungen abrufen

Gibt benutzerspezifische Feature-Flag-Überschreibungen zurück. Diese überschreiben Tenant-Level-Flags für einzelne Benutzer. Wird für Beta-Tests mit bestimmten Benutzern oder Bereitstellung von Premium-Features für ausgewählte Konten verwendet.

Admin/Manager
PUT
/v1/feature-flags/user/{user_id}

Benutzer-Feature-Flag-Überschreibungen aktualisieren

Setzt benutzerspezifische Feature-Flag-Überschreibungen. Überschreibungen können nur eine Teilmenge der Organisationsflags sein - kann keine Flags aktivieren, die für den Tenant nicht verfügbar sind. Gibt aktualisierte Benutzer-Flags zurück.

Admin/Manager

Multi-Tenant- & Systems-Integrator-Verwaltung

Verwalten Sie die Multi-Tenant-Hierarchie einschließlich Systems Integrators (SI), die Public Safety-Deployments für ihre Kunden weiterverkaufen und verwalten.

POST
/v1/systems-integrators

Systems Integrator erstellen

Erstellt eine neue Systems-Integrator-Organisation, die mehrere Kunden-Tenants verwalten kann. Nur Vectis Consilium-Admin. SI erhält eigenes Admin-Portal und kann Kunden-Deployments erstellen/verwalten.

Vectis Consilium-Admin
GET
/v1/systems-integrators

Systems Integrators auflisten

Gibt alle Systems Integrators in der Plattform zurück. Nur Vectis Consilium-Admin. Enthält Metadaten wie Kundenanzahl, Abonnement-Tier und Kontaktinformationen.

Vectis Consilium-Admin
GET
/v1/systems-integrators/{si_id}

Systems-Integrator-Details abrufen

Gibt detaillierte Informationen über einen bestimmten Systems Integrator zurück, einschließlich Kunden, Nutzungsstatistiken und Konfiguration. SI-Admins können nur auf ihren eigenen SI zugreifen.

SI-Admin
GET
/v1/systems-integrators/{si_id}/customers

SI-Kunden auflisten

Gibt alle von einem Systems Integrator verwalteten Kunden-Tenants zurück. SI-Admins können nur ihre eigenen Kunden anzeigen. Enthält Tenant-Status, Benutzeranzahl und Feature-Aktivierung.

SI-Admin
POST
/v1/systems-integrators/{si_id}/customers

Kunden-Tenant erstellen

Erstellt einen neuen Kunden-Tenant unter einem Systems Integrator. Der SI wird zur verwaltenden Entität für Abrechnung und Support. Konfiguriert initiale Features basierend auf dem Abonnement-Tier des SI.

SI-Admin
GET
/v1/tenants/{tenant_id}

Tenant-Details abrufen

Gibt detaillierte Informationen über einen bestimmten Tenant zurück, einschließlich Konfiguration, Features, Nutzungskontingente und Abrechnungsstatus. SI-Admins können nur auf Tenants zugreifen, die sie verwalten.

SI-Admin
PUT
/v1/tenants/{tenant_id}

Tenant aktualisieren

Aktualisiert Tenant-Konfiguration einschließlich Name, Features, Kontingente und Metadaten. Wird verwendet, um Features zu aktivieren/deaktivieren oder Ressourcenlimits für einen Kunden anzupassen.

SI-Admin
DELETE
/v1/tenants/{tenant_id}

Tenant löschen/archivieren

Archiviert oder löscht einen Tenant und alle zugeordneten Daten. Nur Vectis Consilium-Admin. Daten werden 30 Tage vor dauerhafter Löschung aufbewahrt. Wird verwendet, wenn Kunde abwandert oder während Bereinigung.

Vectis Consilium-Admin

Utility & Konfiguration

Administrative Konfigurations- und Utility-Endpunkte.

GET
/v1/portal/admin/config

Admin-Konfiguration abrufen

Gibt Konfigurationsdaten für die Admin-UI zurück, einschließlich verfügbarer Rollen, Berechtigungskatalog, Länderliste, unterstützte Plattformen und Feature-Verfügbarkeit. Wird verwendet, um Admin-Dashboard-Dropdowns und Formulare zu befüllen.

Admin/Manager
GET
/v1/portal/data/countries

Länderliste abrufen

Gibt eine Liste aller Länder mit ihren Regionen/Bundesstaaten für Adressformulare zurück. Enthält ISO-Codes, Namen und Unterteilungen. Öffentlicher Endpunkt für Registrierungs- und Profilformulare.

Öffentlich
GET
/health

Health Check

Einfacher Health-Check-Endpunkt, der Servicestatus zurückgibt. Wird von Load Balancern und Überwachungssystemen verwendet. Gibt status: healthy, service: auth_service zurück.

Öffentlich
GET
/v1/platforms/supported

Unterstützte Plattformen auflisten

Gibt die Liste der Plattformen zurück, die bei Token-Ausstellung angegeben werden können. Plattformen repräsentieren verschiedene Public Safety-Produkte/Module, auf die ein Benutzer zugreifen kann. Aus Firestore-Konfiguration abgerufen.

Öffentlich
GET
/audit/logs

Audit-Logs abrufen

Gibt Sicherheits-Audit-Logs für den Authentifizierungsservice zurück. Enthält Login-Versuche, Berechtigungsänderungen und administrative Aktionen. Administrator mit Audit-Berechtigung erforderlich.

Administrator

API-Service-Endpunkte

Der API-Service (api.knogin.com) ist die zentrale Intelligence-Plattform mit 130+ REST-Endpunkten für Ermittlungen, Vorgänge, Profile, Beweise, Alarme, KI-Services, Echtzeitkommunikation und mehr. Alle Endpunkte erfordern Authentifizierung, sofern nicht als öffentlich gekennzeichnet.

Health & Systemfähigkeiten

System-Health-Monitoring und Endpunkte zur Erkennung von Fähigkeiten für Integration und Überwachung.

GET
/api/v1/health

Umfassender Health Check

Gibt detaillierten Health-Status aller Systemkomponenten zurück, einschließlich Neo4j-Graph-Datenbank, PostgreSQL-Relationsdatenbank, Redis-Cache, KI-Services (OpenAI, Anthropic, Google AI) und externe Integrationen. Response enthält Latenzmetriken und Verbindungsstatus für jede Komponente. Wird für Operations-Monitoring und Incident Response verwendet.

Öffentlich
GET
/api/v1/health/simple

Einfacher Health Check

Leichtgewichtiger Health Check mit minimaler Response für Load Balancer und Orchestrierungssysteme (Kubernetes, Cloud Run). Gibt 200 OK zurück, wenn Service läuft. Prüft keine Downstream-Abhängigkeiten für schnellere Antwortzeit.

Öffentlich
GET
/api/v1/health/db-check

Datenbank-Konnektivitätsprüfung

Verifiziert Konnektivität zu allen Datenbanksystemen (Neo4j, PostgreSQL, Firestore). Gibt individuellen Status für jede Datenbank zurück. Wird für Deployment-Verifizierung und Troubleshooting von Konnektivitätsproblemen verwendet.

Öffentlich
GET
/api/v1/health/connectivity

Externe Service-Konnektivität

Prüft Konnektivität zu allen externen Services einschließlich KI-Provider, OSINT-Datenquellen, Speichersysteme und Benachrichtigungsservices. Gibt detaillierten Status für jeden Integrationspunkt zurück.

Öffentlich
GET
/api/v1/capabilities

Systemfähigkeiten

Gibt umfassende Systemfähigkeiten für Frontend-Konfiguration zurück, einschließlich unterstützter Domänen, verfügbarer OSINT-Provider, akzeptierter Dateiformate, API-Endpunkte, aktivierter Features, Rate-Limits und maximaler Dateigrößen. Essentiell für dynamische UI-Konfiguration.

Öffentlich

Intelligence-Verarbeitung

KI-gestützte Dokumentenverarbeitung zur Extraktion von Entitäten, Beziehungen und Intelligence aus Text-, Bild-, Audio- und Videodateien.

POST
/api/v1/intelligence/process-text

Textdokument verarbeiten

Laden Sie Text-, PDF- oder DOCX-Dateien für Ermittlungen hoch und verarbeiten Sie sie. Verwendet KI zur Extraktion von Entitäten (Personen, Organisationen, Standorte), Beziehungen, Ereignissen und wichtiger Intelligence aus Dokumenten. Unterstützt Dateien bis 50MB. Ergebnisse werden gespeichert und mit der Ermittlung verknüpft.

Auth erforderlich
POST
/api/v1/intelligence/process-text/base64

Textdokument verarbeiten (Base64)

Cloudflare-kompatibler Endpunkt zur Verarbeitung base64-kodierter Dokumentdateien. Akzeptiert JSON-Body mit file_content, filename und mime_type. Unterstützt .txt-, .pdf- und .docx-Formate. Ideal für serverlose Umgebungen.

Auth erforderlich
POST
/api/v1/process-image-file

Bild verarbeiten

Laden Sie Bilder für KI-gestützte visuelle Analyse hoch und verarbeiten Sie sie. Führt OCR-Textextraktion, Objekterkennung, Gesichtserkennung, Standortidentifikation und Szenenklassifizierung durch. Unterstützt JPEG-, PNG-, GIF- und WebP-Formate.

Auth erforderlich
POST
/api/v1/process-image-file/base64

Bild verarbeiten (Base64)

Cloudflare-kompatibler Endpunkt zur Verarbeitung base64-kodierter Bilder. Gibt extrahierten Text, erkannte Objekte, Gesichter und identifizierte Standorte zurück. Ideal für serverlose Umgebungen mit Request-Body-Größenbeschränkungen.

Auth erforderlich
POST
/api/v1/process-audio-file

Audio verarbeiten

Laden Sie Audiodateien für Transkription und Sprechererkennung hoch und verarbeiten Sie sie. Verwendet fortgeschrittene Speech-to-Text und Speaker Diarization. Unterstützt MP3-, WAV-, OGG- und M4A-Formate bis 100MB.

Auth erforderlich
POST
/api/v1/process-audio-file/base64

Audio verarbeiten (Base64)

Cloudflare-kompatibler Endpunkt zur Verarbeitung base64-kodierter Audiodaten. Gibt vollständige Transkription mit Zeitstempeln und Sprecher-Labels zurück. Hinweis: Große Audiodateien sollten direkten Upload-Endpunkt verwenden.

Auth erforderlich
POST
/api/v1/process-video-file

Video verarbeiten

Laden Sie Videodateien für umfassende Analyse hoch und verarbeiten Sie sie. Extrahiert Audio-Transkription, erkennt Gesichter über Frames hinweg, identifiziert Szenen und Objekte und generiert visuelle Timeline. Unterstützt MP4, MOV, AVI, WebM bis 500MB.

Auth erforderlich
POST
/api/v1/process-video-file/base64

Video verarbeiten (Base64)

Cloudflare-kompatibler Endpunkt zur Verarbeitung base64-kodierter Videos. Begrenzt auf kleinere Dateien aufgrund Kodierungs-Overhead. Für größere Videos verwenden Sie Presigned-URL-Upload.

Auth erforderlich

Profilverwaltung

Erstellen, aktualisieren und anreichern Sie Entitätsprofile mit Daten von OSINT-Providern. Unterstützt Einzel- und Batch-Operationen.

POST
/api/v1/profiles

Profil erstellen

Erstellt ein neues Entitätsprofil (Person, Organisation, Fahrzeug, etc.). Akzeptiert initiale Daten und validiert/normalisiert Felder automatisch. Löst Hintergrund-Anreicherung aus, wenn auto_enrich aktiviert ist.

Auth erforderlich
GET
/api/v1/profiles/{profile_id}

Profil abrufen

Gibt vollständige Profildaten zurück, einschließlich aller Attribute, verknüpfter Entitäten, Timeline und Anreicherungsdaten. Unterstützt Feldauswahl zur Performance-Optimierung.

Auth erforderlich
PUT
/api/v1/profiles/{profile_id}

Profil aktualisieren

Aktualisiert Profilfelder. Unterstützt partielle Updates. Pflegt Audit-Trail aller Änderungen. Löst erneute Anreicherung aus, wenn Kern-Identifikationsfelder modifiziert werden.

Auth erforderlich
DELETE
/api/v1/profiles/{profile_id}

Profil löschen

Soft-löscht ein Profil und alle verknüpften Daten. Profil kann innerhalb von 30 Tagen wiederhergestellt werden. Wird nach Aufbewahrungsfrist dauerhaft gelöscht. Audit-Trail bleibt erhalten.

Auth erforderlich
POST
/api/v1/profiles/{profile_id}/enrich

Profil anreichern

Reichert ein Profil mit Daten von OSINT-Providern an. Optional können Sie angeben, welche Provider verwendet werden sollen (Social, Criminal, Financial, etc.). Gibt aggregierte Daten zurück, einschließlich Social-Media-Präsenz, öffentlicher Aufzeichnungen und Open-Source-Intelligence.

Auth erforderlich
POST
/api/v1/batch/profiles

Batch-Profil-Abruf

Ruft mehrere Profile nach ID in einer einzigen Anfrage ab. Maximal 100 Profile pro Anfrage. Gibt Profile in derselben Reihenfolge wie angeforderte IDs zurück. Fehlende Profile geben null zurück.

Auth erforderlich
POST
/api/v1/batch/enrich

Batch-Profil-Anreicherung

Reichert mehrere Profile in einer einzigen Anfrage an. Maximal 10 Profile pro Anfrage zur Verwaltung von Provider-Rate-Limits. Gibt individuellen Erfolgs-/Fehlerstatus für jedes Profil zurück.

Auth erforderlich
GET
/api/v1/profiles/search

Volltextsuche über alle Profilfelder. Unterstützt Filter nach Typ, Status, Datumsbereich und benutzerdefinierten Feldern. Gibt paginierte Ergebnisse mit Relevanz-Scoring zurück.

Auth erforderlich
POST
/api/v1/profiles/link

Erstellt eine Beziehung zwischen zwei Profilen (z.B. 'works_for', 'related_to', 'owns'). Speichert Beziehungsmetadaten und Beweise. Bidirektionale Beziehungen werden automatisch erstellt.

Auth erforderlich
DELETE
/api/v1/profiles/link

Entfernt eine Beziehung zwischen zwei Profilen. Pflegt Audit-Trail der Entfernung. Ursprüngliche Beziehungsdaten werden für Compliance aufbewahrt.

Auth erforderlich

Ermittlungen & Vorgänge

Verwalten Sie Ermittlungen, Vorgänge, Aufgaben und den gesamten Ermittlungslebenszyklus.

POST
/api/v1/investigations

Ermittlung erstellen

Erstellt einen neuen Ermittlungsarbeitsbereich mit Titel, Beschreibung und Klassifizierungsstufe. Weist automatisch den Ersteller als leitenden Ermittler zu. Gibt Ermittlungs-ID für nachfolgende Operationen zurück.

Auth erforderlich
GET
/api/v1/investigations/{investigation_id}

Ermittlung abrufen

Gibt vollständige Ermittlungsdetails zurück, einschließlich Metadaten, Teammitgliedern, Vorgängen, Profilen, Dateien und Aktivitäts-Timeline. Unterstützt Feldauswahl für große Ermittlungen.

Auth erforderlich
PUT
/api/v1/investigations/{investigation_id}

Ermittlung aktualisieren

Aktualisiert Ermittlungsmetadaten einschließlich Titel, Beschreibung, Status und Klassifizierung. Änderungen lösen Benachrichtigungen an Teammitglieder aus. Audit-protokolliert.

Auth erforderlich
DELETE
/api/v1/investigations/{investigation_id}

Ermittlung löschen

Soft-löscht eine Ermittlung und alle enthaltenen Daten. Erfordert Bestätigung für Ermittlungen mit aktiven Vorgängen. Daten werden für Compliance-Zeitraum aufbewahrt.

Auth erforderlich
GET
/api/v1/investigations

Ermittlungen auflisten

Gibt für den aktuellen Benutzer zugängliche Ermittlungen zurück. Unterstützt Filterung nach Status, Datum, Teammitglied und Suchanfrage. Paginiert mit Sortieroptionen.

Auth erforderlich
POST
/api/v1/investigations/{investigation_id}/files

Dateien zu Ermittlung hinzufügen

Verknüpft hochgeladene Dateien mit einer Ermittlung. Dateien werden basierend auf Typ automatisch für KI-Verarbeitung in die Warteschlange gestellt. Löst Indizierung für Suche aus.

Auth erforderlich

Alarme & Monitore

Konfigurieren Sie Überwachungsregeln und verwalten Sie Alarme, die durch Echtzeit-Datenströme ausgelöst werden.

POST
/api/v1/alerts

Erstellen Alarm

Erstellt programmatisch einen Alarm. Typischerweise werden Alarme von Monitoren erstellt, aber manuelle Erstellung wird für Integrationen unterstützt. Erfordert Titel, Schweregrad und mindestens eine Entitätsreferenz.

Auth erforderlich
GET
/api/v1/alerts/{alert_id}

Abrufen Alarm

Gibt vollständige Alarmdetails zurück, einschließlich auslösender Daten, übereinstimmender Entitäten, Entscheidungsverlauf und verknüpfter Ermittlungen. Unterstützt Erweiterung verwandter Entitäten.

Auth erforderlich
PUT
/api/v1/alerts/{alert_id}

Aktualisieren Alarm

Aktualisiert Alarmmetadaten oder Status. Statusübergänge werden validiert (z.B. kann ein abgewiesener Alarm nicht wieder geöffnet werden). Alle Änderungen werden mit Benutzer und Zeitstempel audit-protokolliert.

Auth erforderlich
POST
/api/v1/alerts/{alert_id}/decide

Alarm entscheiden

Erfasst eine Entscheidung zu einem Alarm: eskalieren, untersuchen, verwerfen oder Falschmeldung. Entscheidung enthält Begründung und optionale Entitätsdisposition. Geschlossene Alarme können Folge-Workflows auslösen.

Auth erforderlich
GET
/api/v1/alerts

Auflisten Alarme

Gibt Alarme zurück, die Filterkriterien entsprechen. Unterstützt Filterung nach Schweregrad, Status, Monitor, Datumsbereich und Entität. Paginiert mit konfigurierbarer Seitengröße.

Auth erforderlich

Alarme & Monitore

Konfigurieren Sie Überwachungsregeln und verwalten Sie Alarme, die durch Echtzeit-Datenströme ausgelöst werden.

POST
/api/v1/monitors

Erstellen Monitor

Erstellt eine Überwachungsregel, die Alarme basierend auf Datenstream-Mustern auslöst. Unterstützt komplexe Bedingungen mit Entitäts-Matching, geografischen Grenzen, zeitlichen Mustern und Schwellenwert-Triggern.

Auth erforderlich
GET
/api/v1/monitors/{monitor_id}

Abrufen Monitor

Gibt Monitor-Konfiguration und Statistiken zurück, einschließlich Alarmanzahl, letztem Trigger-Zeitpunkt und Performance-Metriken. Enthält Bedingungsdetails und Benachrichtigungseinstellungen.

Auth erforderlich
PUT
/api/v1/monitors/{monitor_id}

Aktualisieren Monitor

Aktualisiert Monitor-Bedingungen, Schwellenwerte oder Benachrichtigungseinstellungen. Änderungen werden sofort wirksam. Das Pausieren eines Monitors stoppt neue Alarme, bewahrt aber den Verlauf.

Auth erforderlich
DELETE
/api/v1/monitors/{monitor_id}

Löschen Monitor

Löscht einen Monitor dauerhaft. Zugeordnete Alarme werden aufbewahrt, aber als verwaist markiert. Erwägen Sie stattdessen das Pausieren zur Erhaltung des Audit-Trails.

Auth erforderlich
GET
/api/v1/monitors

Auflisten Monitore

Gibt alle Monitore für den aktuellen Tenant zurück. Unterstützt Filterung nach Status, Typ und Alarmaktivität. Enthält zusammenfassende Statistiken für jeden Monitor.

Auth erforderlich
POST
/api/v1/ai/generate-monitor-spec

Monitor aus Beschreibung generieren

Verwendet KI zur Umwandlung natürlichsprachlicher Beschreibungen in strukturierte Monitor-Spezifikationen. Enthält Sicherheitsanalyse, Parameterextraktion und geschätztes Alarmvolumen. Hilft nicht-technischen Benutzern, komplexe Monitore zu erstellen.

Auth erforderlich

KI-Services

Direkter Zugriff auf KI-Fähigkeiten einschließlich Textanalyse, Entitätsextraktion, Beziehungsmapping und natürlicher Sprachverarbeitung.

POST
/api/v1/ai/analyze-text

Text mit KI analysieren

Führt umfassende KI-Analyse von Textinhalten durch. Extrahiert Entitäten, Beziehungen, Ereignisse, Stimmung und Schlüsselthemen. Unterstützt mehrere Sprachen mit automatischer Erkennung.

Auth erforderlich
POST
/api/v1/ai/generate-graph

Graph aus Text generieren

Erstellt einen Wissensgraphen aus unstrukturiertem Text. Identifiziert Entitäten, leitet Beziehungen ab und generiert strukturierte Graphdaten, die für Visualisierung oder Neo4j-Import geeignet sind.

Auth erforderlich
POST
/api/v1/ai/summarize

Inhalt zusammenfassen

Generiert prägnante Zusammenfassungen von Langform-Inhalten. Unterstützt mehrere Zusammenfassungslängen und -stile (Exekutiv, Technisch, Stichpunkte). Bewahrt Schlüsselentitäten und Fakten.

Auth erforderlich
POST
/api/v1/ai/translate

Inhalt übersetzen

Übersetzt Inhalte zwischen unterstützten Sprachen unter Beibehaltung von Entitätsnamen und technischen Begriffen. Gibt sowohl Übersetzung als auch erkannte Ausgangssprache zurück.

Auth erforderlich
POST
/api/v1/ai/extract-entities

Benannte Entitäten extrahieren

Extrahiert und klassifiziert benannte Entitäten aus Text. Gibt Entitätsspannen, Typen, Konfidenzwerte und aufgelöste Identifikatoren zurück, sofern verfügbar. Unterstützt benutzerdefinierte Entitätstypen.

Auth erforderlich

Dateiverwaltung

Hochladen, Herunterladen und Verwalten von Dateien mit vollständiger RBAC-Durchsetzung und Audit-Protokollierung.

POST
/api/v1/files

Datei hochladen

Lädt eine Datei in sicheren Speicher hoch. Erkennt automatisch den Dateityp und stellt ihn zur entsprechenden Verarbeitung in die Warteschlange. Gibt Datei-ID und Verarbeitungsstatus zurück. Unterstützt chunked Uploads für große Dateien.

Auth erforderlich
GET
/api/v1/files/{file_id}/download

Datei herunterladen

Lädt eine Datei mit vollständiger RBAC-Durchsetzung und Audit-Logging herunter. Verifiziert, dass der Benutzer Zugriff auf die zugeordnete Ermittlung/Vorgang hat. Unterstützt Range-Requests für große Dateien. Gibt Datei mit entsprechenden Content-Type-Headern zurück.

Auth erforderlich
GET
/api/v1/files/{file_id}/stream

Datei streamen

Streamt eine Datei für progressives Laden großer Dateien. Unterstützt HTTP-Range-Requests zum Spulen in Audio/Video-Dateien. Effizienter als vollständiger Download für große Mediendateien.

Auth erforderlich
GET
/api/v1/files/{file_id}/presigned-url

Presigned-URL abrufen

Generiert eine zeitlich begrenzte Presigned-URL für direkten Dateizugriff vom Cloudflare R2-Speicher. URL läuft nach konfigurierbarer Dauer ab (Standard 1 Stunde). Nützlich zum Einbetten von Dateien in Berichte oder Teilen mit externen Tools.

Auth erforderlich
GET
/api/v1/admin/files

Alle Dateien auflisten (Admin)

Gibt alle Dateien im System mit Metadaten und Zugriffsstatistiken zurück. Nur Admin oder Superuser. Unterstützt Tenant-Filterung für Multi-Tenant-Deployments. Wird für Speicherverwaltung und Auditing verwendet.

Admin/Superuser
GET
/api/v1/admin/files/{file_id}/audit

Datei-Audit-Trail (Admin)

Gibt vollständigen Audit-Trail für eine spezifische Datei zurück, einschließlich aller Zugriffsereignisse, Downloads und Modifikationen. Nur Admin oder Superuser. Essentiell für Chain-of-Custody-Dokumentation.

Admin/Superuser

API-Metadaten & Dokumentation

Selbstbeschreibende API-Endpunkte für dynamische Integration und Dokumentation.

GET
/api/v1/docs/endpoints

API Endpoint Documentation

Gibt umfassende Dokumentation aller API-Endpunkte zurück, einschließlich Pfaden, Methoden, Parametern und Response-Schemas. Wird zur Generierung von Client-SDKs und Integrationsdokumentation verwendet.

Öffentlich
GET
/api/v1/metadata/domains

Domänen-Metadaten

Gibt Metadaten über alle verfügbaren Domänen (Entitätstypen) zurück, einschließlich deren Eigenschaften, Beziehungen und UI-Konfiguration. Essentiell für den Aufbau dynamischer UIs, die sich an Schema-Änderungen anpassen.

Öffentlich
GET
/api/v1/metadata/enums

Enum-Metadaten

Gibt alle in der API verwendeten Aufzählungstypen zurück, einschließlich Statuscodes, Prioritätsstufen, Klassifizierungsstufen und anderen kategorialen Werten. Wird zum Befüllen von Dropdown-Menüs verwendet.

Öffentlich
GET
/api/v1/metadata/providers

Provider-Metadaten

Gibt Metadaten über verfügbare OSINT- und Datenanbieter zurück, einschließlich Fähigkeiten, Rate-Limits und erforderlicher Zugangsdaten. Wird zur Konfiguration von Datenquellen präferenzen verwendet.

Öffentlich

Audit & Compliance

Kryptografische Audit-Trails mit Merkle-Tree-Verifizierung für manipulationssichere Protokollierung.

GET
/api/v1/audit/anchor/latest

Neuesten Merkle-Anchor abrufen

Gibt den neuesten Merkle-Tree-Root-Hash zurück, der das Audit-Log verankert. Wird für kryptografische Verifizierung der Log-Integrität verwendet. Anchor wird periodisch zur Unveränderlichkeit auf Blockchain veröffentlicht.

Öffentlich
GET
/api/v1/audit/anchor/proof/{entry_id}

Inclusion-Proof abrufen

Gibt einen Merkle-Inclusion-Proof für einen spezifischen Audit-Eintrag zurück. Proof kann unabhängig gegen den veröffentlichten Anchor verifiziert werden. Essentiell für forensische Chain-of-Custody-Anforderungen.

Öffentlich

Mission Planning

AI-assisted mission planning and operational support.

POST
/api/v1/mission-plans

Generieren Missionsplan

KI-unterstützte Missionsplanung basierend auf Szenariobeschreibung, Zielprofilen, geografischen Einschränkungen und Bedrohungsbewertung. Gibt strukturierten Plan mit Ressourcenzuweisung, Zeitplan und Eventualitäten zurück.

Auth erforderlich
PUT
/api/v1/mission-plans/{plan_id}

Missionsplan verfeinern

Verfeinert iterativ einen bestehenden Missionsplan basierend auf neuen Einschränkungen oder Feedback. Pflegt Planverlauf zum Vergleich. Unterstützt partielle Updates spezifischer Planabschnitte.

Auth erforderlich

Vorgangverwaltung

Vollständiges Vorgang-Lifecycle-Management mit Workflow, Zuweisungen, Vorlagen und Timeline-Tracking.

POST
/api/v1/cases

Erstellen Vorgang

Erstellt einen neuen Vorgang innerhalb einer Ermittlung. Akzeptiert Titel, Beschreibung, Priorität, Status und zugewiesenen Benutzer. Generiert automatisch eine eindeutige Vorgangnummer und erstellt initialen Timeline-Eintrag.

Auth erforderlich
GET
/api/v1/cases/{case_id}

Abrufen Vorgang

Gibt vollständige Vorgangdetails zurück, einschließlich Metadaten, zugewiesener Benutzer, verknüpfter Profile, Aufgaben, Notizen, Anhänge und vollständiger Aktivitäts-Timeline. Unterstützt Feldauswahl für Performance.

Auth erforderlich
PUT
/api/v1/cases/{case_id}

Aktualisieren Vorgang

Aktualisiert Vorgang-Metadaten einschließlich Titel, Beschreibung, Priorität, Status, Fälligkeitsdatum und benutzerdefinierter Felder. Änderungen werden mit Benutzer und Zeitstempel audit-protokolliert.

Auth erforderlich
DELETE
/api/v1/cases/{case_id}

Löschen Vorgang

Soft-löscht einen Vorgang und alle zugeordneten Daten. Erfordert Bestätigung für Vorgänge mit aktiven Aufgaben. Daten werden für Compliance-Zeitraum vor permanenter Löschung aufbewahrt.

Auth erforderlich
GET
/api/v1/cases

Auflisten Vorgänge

Gibt Vorgänge mit Filterung nach Ermittlung, Status, Priorität, Beauftragtem, Datumsbereich und Tags zurück. Unterstützt Paginierung, Sortierung und Volltextsuche über Vorganginhalte.

Auth erforderlich
POST
/api/v1/cases/{case_id}/assign

Assign Case

Assigns or reassigns a case to a user or team. Supports multiple assignees with primary/secondary designation. Triggers notification to assigned users.

Auth erforderlich
POST
/api/v1/cases/{case_id}/status

Aktualisieren Vorgang Status

Aktualisiert Vorgang-Status mit Workflow-Validierung. Statusübergänge werden basierend auf Workflow-Regeln validiert. Löst automatisierte Aktionen basierend auf Status aus (z.B. Benachrichtigungen, Aufgabenerstellung).

Auth erforderlich
POST
/api/v1/cases/{case_id}/link-profile

Verknüpft ein Entitätsprofil mit einem Vorgang. Geben Sie den Beziehungstyp (Subjekt, Zeuge, Opfer usw.) und Relevanznotizen an. Erstellt bidirektionale Verknüpfung, die sowohl im Vorgang als auch im Profil sichtbar ist.

Auth erforderlich
DELETE
/api/v1/cases/{case_id}/link-profile/{profile_id}

Entfernt die Verknüpfung zwischen einem Profil und einem Vorgang. Ursprüngliche Verknüpfungsdaten werden im Audit-Trail für Compliance aufbewahrt.

Auth erforderlich
GET
/api/v1/cases/{case_id}/timeline

Abrufen Vorgang Timeline

Gibt die vollständige Aktivitäts-Timeline für einen Vorgang zurück, einschließlich Statusänderungen, Zuweisungen, Profil-Verknüpfungen, Aufgabenabschlüssen und allen Modifikationen mit Zeitstempeln und Akteuren.

Auth erforderlich
POST
/api/v1/cases/bulk-update

Bulk-Aktualisieren Vorgänge

Aktualisiert mehrere Vorgänge in einer einzigen Anfrage. Unterstützt Aktualisierung von Status, Priorität, Beauftragtem oder Tags. Maximum 100 Vorgänge pro Anfrage. Gibt individuellen Erfolg/Fehler für jeden Vorgang zurück.

Auth erforderlich
POST
/api/v1/cases/from-template

Erstellen Vorgang from Vorlage

Erstellt einen neuen Vorgang unter Verwendung einer vordefinierten Vorlage. Vorlage definiert Standard-Aufgaben, Checklisten, Felder und Workflow-Phasen. Akzeptiert Überschreibungen für Vorlagenwerte.

Auth erforderlich

Aufgabenverwaltung

Erstellen und verwalten Sie Aufgaben mit Zuweisungen, Checklisten, Abhängigkeiten und Fortschrittsverfolgung.

POST
/api/v1/tasks

Erstellen Aufgabe

Erstellt eine neue Aufgabe innerhalb eines Vorgangs. Akzeptiert Titel, Beschreibung, Beauftragten, Fälligkeitsdatum, Priorität und optionale Checklistenelemente. Unterstützt übergeordnete Aufgabe für Unteraufgaben-Hierarchien.

Auth erforderlich
GET
/api/v1/tasks/{task_id}

Abrufen Aufgabe

Gibt vollständige Aufgabendetails zurück, einschließlich Metadaten, Checklistenelemente, Unteraufgaben, Kommentare, Anhänge und Zeitverfolgungsinformationen.

Auth erforderlich
PUT
/api/v1/tasks/{task_id}

Aktualisieren Aufgabe

Aktualisiert Aufgabenfelder einschließlich Titel, Beschreibung, Fälligkeitsdatum, Priorität und Fortschritt. Unterstützt partielle Updates. Änderungen werden audit-protokolliert.

Auth erforderlich
DELETE
/api/v1/tasks/{task_id}

Löschen Aufgabe

Löscht eine Aufgabe und optional deren Unteraufgaben. Abgeschlossene Aufgaben werden archiviert statt gelöscht. Audit-Trail wird aufbewahrt.

Auth erforderlich
GET
/api/v1/cases/{case_id}/tasks

Auflisten Aufgaben by Vorgang

Gibt alle Aufgaben für einen Vorgang mit Filterung nach Status, Beauftragtem, Fälligkeitsdatum und Priorität zurück. Unterstützt hierarchische Ansicht mit Unteraufgaben, die unter übergeordneten Aufgaben verschachtelt sind.

Auth erforderlich
POST
/api/v1/tasks/{task_id}/assign

Assign Task

Assigns or reassigns a task to a user. Triggers notification to assigned user. Updates workload calculations for capacity planning.

Auth erforderlich
POST
/api/v1/tasks/{task_id}/complete

Complete Task

Markiert eine Aufgabe als abgeschlossen mit optionalen Abschlussnotizen. Validiert, dass alle erforderlichen Checklistenelemente abgeschlossen sind. Aktualisiert Vorgang-Fortschrittsmetriken.

Auth erforderlich
POST
/api/v1/tasks/{task_id}/checklist

Aktualisieren Aufgabe Checkliste

Aktualisiert Checklistenelemente für eine Aufgabe. Hinzufügen, Entfernen oder Umschalten des Abschlussstatus einzelner Elemente. Unterstützt Neuordnung von Checklistenelementen.

Auth erforderlich
GET
/api/v1/tasks/my-tasks

Meine Aufgaben abrufen

Gibt alle dem aktuellen Benutzer zugewiesenen Aufgaben über alle Vorgänge zurück. Unterstützt Filterung nach Status, Fälligkeitsdatum und Priorität. Nützlich für persönliches Aufgaben-Dashboard.

Auth erforderlich
POST
/api/v1/tasks/bulk-update

Bulk-Aktualisieren Aufgaben

Aktualisiert mehrere Aufgaben in einer einzigen Anfrage. Unterstützt Aktualisierung von Status, Beauftragtem, Fälligkeitsdatum oder Priorität. Maximum 50 Aufgaben pro Anfrage.

Auth erforderlich

Notizen & Dokumentation

Ermittlungsnotizen mit Rich-Text, Threading, Anhängen und Sichtbarkeitskontrollen.

POST
/api/v1/notes

Erstellen Notiz

Erstellt eine neue Notiz, die an einen Vorgang oder eine Ermittlung angehängt ist. Unterstützt Rich-Text-Inhalte, Erwähnungen (@user) und Klassifizierungsstufen. Indiziert automatisch Inhalte für Suche.

Auth erforderlich
GET
/api/v1/notes/{note_id}

Abrufen Notiz

Gibt Notizinhalte mit Metadaten, Anhängen und Thread-Antworten zurück. Respektiert Sichtbarkeitseinstellungen (öffentlich, Team, privat).

Auth erforderlich
PUT
/api/v1/notes/{note_id}

Aktualisieren Notiz

Aktualisiert Notizinhalt oder Metadaten. Pflegt Versionsverlauf für Audit-Compliance. Nur Ersteller oder Admins können vertrauliche Notizen bearbeiten.

Auth erforderlich
DELETE
/api/v1/notes/{note_id}

Löschen Notiz

Soft-löscht eine Notiz. Inhalt wird für Compliance-Zeitraum aufbewahrt. Vertrauliche Notizen erfordern Admin-Genehmigung zum Löschen.

Auth erforderlich
GET
/api/v1/cases/{case_id}/notes

Auflisten Notizen by Vorgang

Gibt alle Notizen für einen Vorgang unter Berücksichtigung von Sichtbarkeitsregeln zurück. Unterstützt Filterung nach Notiztyp, Autor und Datumsbereich. Standardmäßig nach Erstellungsdatum sortiert.

Auth erforderlich
POST
/api/v1/notes/{note_id}/attachments

Anhang zu Notiz hinzufügen

Hängt eine Datei an eine bestehende Notiz an. Datei wird automatisch basierend auf dem Typ verarbeitet. Wahrt Chain-of-Custody für beweisrelevante Anhänge.

Auth erforderlich
POST
/api/v1/notes/{note_id}/reply

Auf Notiz antworten

Erstellt eine Thread-Antwort auf eine bestehende Notiz. Unterstützt @Erwähnungen zur Benachrichtigung spezifischer Benutzer. Erhält Gesprächskontext für Zusammenarbeit.

Auth erforderlich

Anhänge & Dateien

Verwalten Sie Dateianhänge mit Verarbeitung, Chain of Custody und Integritätsverifizierung.

POST
/api/v1/attachments

Erstellen Anhang

Lädt eine Datei hoch und hängt sie an einen Vorgang, eine Notiz oder eine Aufgabe an. Erkennt automatisch den Dateityp und stellt ihn zur entsprechenden KI-Verarbeitung in die Warteschlange. Berechnet Integritätshash für Beweiskette.

Auth erforderlich
GET
/api/v1/attachments/{attachment_id}

Abrufen Anhang

Gibt Anhang-Metadaten zurück, einschließlich Dateiinformationen, Verarbeitungsstatus, extrahierten Inhalten und Zugriffsverlauf. Unterstützt Thumbnail- und Vorschau-URLs für Mediendateien.

Auth erforderlich
DELETE
/api/v1/attachments/{attachment_id}

Löschen Anhang

Soft-löscht einen Anhang. Datei verbleibt im Speicher für Compliance-Zeitraum. Beweisrelevante Anhänge erfordern Genehmigungsworkflow zum Löschen.

Auth erforderlich
GET
/api/v1/cases/{case_id}/attachments

Auflisten Anhänge by Vorgang

Gibt alle Anhänge für einen Vorgang mit Filterung nach Dateityp, Verarbeitungsstatus und Upload-Datum zurück. Enthält aggregierte Statistiken (Gesamtgröße, Dateianzahl nach Typ).

Auth erforderlich
POST
/api/v1/attachments/{attachment_id}/process

Anhang erneut verarbeiten

Löst erneute Verarbeitung eines Anhangs mit aktualisierten KI-Modellen oder unterschiedlichen Verarbeitungsoptionen aus. Nützlich, wenn neue Extraktionsfähigkeiten verfügbar werden.

Auth erforderlich
GET
/api/v1/attachments/{attachment_id}/chain-of-custody

Anhang-Chain-of-Custody abrufen

Gibt das vollständige Chain-of-Custody-Log für einen Anhang zurück, einschließlich aller Zugriffsereignisse, Übertragungen und Modifikationen. Essentiell für rechtliche Zulässigkeit.

Auth erforderlich

Graph-Analyse

Netzwerkanalyse, Pfadfindung, Zentralitätsmetriken und Community-Erkennung im Wissensgraphen.

GET
/api/v1/graph/node/{node_id}

Abrufen Graph Knoten

Gibt einen einzelnen Knoten aus dem Wissensgraphen mit allen Eigenschaften und Labels zurück. Enthält Kantenanzahl und Beispielbeziehungen für Kontext.

Auth erforderlich
GET
/api/v1/graph/node/{node_id}/neighbors

Abrufen Knoten Nachbarn

Gibt alle direkt verbundenen Knoten innerhalb angegebener Tiefe zurück. Unterstützt Filterung nach Beziehungstyp und Knotenlabels. Konfigurierbare Tiefenbegrenzung (max 5) zur Vermeidung von Performance-Problemen.

Auth erforderlich
GET
/api/v1/graph/path

Pfad zwischen Knoten finden

Findet kürzeste(n) Pfad(e) zwischen zwei Knoten mittels Dijkstra- oder A*-Algorithmen. Gibt Pfadknoten, Beziehungen und Gesamtgewicht zurück. Unterstützt gewichtete Kanten für intelligentes Routing.

Auth erforderlich
POST
/api/v1/graph/subgraph

Abrufen Teilgraph

Extrahiert einen Teilgraphen um angegebene Seed-Knoten. Gibt Knoten und Kanten innerhalb angegebener Hops zurück. Nützlich für fokussierte Visualisierung von Entitäts-Nachbarschaften.

Auth erforderlich
POST
/api/v1/graph/query

Benutzerdefinierte Cypher-Abfrage ausführen

Führt eine Read-Only-Cypher-Abfrage gegen die Graph-Datenbank aus. Abfrage wird validiert und zur Sicherheit sandboxed. Gibt Ergebnisse in tabellarischem oder Graph-Format zurück. Nur Admin.

Auth erforderlich
GET
/api/v1/graph/statistics

Graph-Statistiken abrufen

Gibt aggregierte Statistiken über den Wissensgraphen zurück, einschließlich Knotenanzahl nach Label, Kantenanzahl nach Typ und Graphdichte-Metriken.

Auth erforderlich
POST
/api/v1/graph/centrality

Zentralität berechnen

Berechnet Zentralitätsmetriken (Degree, Betweenness, PageRank) für angegebene Knoten oder den gesamten Graphen. Wird zur Identifikation von Schlüsselentitäten in einem Netzwerk verwendet.

Auth erforderlich
POST
/api/v1/graph/community-detection

Communities erkennen

Führt Community-Erkennungsalgorithmen (Louvain, Label Propagation) aus, um Cluster verwandter Entitäten zu identifizieren. Gibt Community-Zuweisungen und Modularitätswerte zurück.

Auth erforderlich
POST
/api/v1/graph/link-prediction

Verwendet Graph-ML zur Vorhersage wahrscheinlicher, aber nicht beobachteter Beziehungen zwischen Entitäten. Gibt Kandidatenlinks mit Konfidenzwerten zurück. Nützlich für Ermittlungshinweise.

Auth erforderlich

Geospatial Intelligence

Standortbasierte Abfragen, Clustering, Heatmaps, Routing und geografische Timeline-Analyse.

POST
/api/v1/geo/search

Sucht nach Entitäten mit Standortdaten, die räumliche Kriterien erfüllen. Kombiniert geografische Grenzen mit Entitätsfiltern (Typ, Datum, Tags). Gibt Ergebnisse mit Entfernung vom Referenzpunkt zurück.

Auth erforderlich
POST
/api/v1/geo/within-bounds

Entitäten innerhalb Grenzen

Gibt alle Entitäten mit Standorten innerhalb einer rechteckigen Begrenzungsbox zurück, die durch Nordost- und Südwest-Koordinaten definiert ist. Optimiert für Karten-Viewport-Abfragen.

Auth erforderlich
POST
/api/v1/geo/within-radius

Entitäten innerhalb Radius

Gibt alle Entitäten innerhalb eines angegebenen Radius von einem Mittelpunkt zurück. Distanz berechnet mit Haversine-Formel. Ergebnisse enthalten Entfernung vom Zentrum.

Auth erforderlich
POST
/api/v1/geo/within-polygon

Entitäten innerhalb Polygon

Gibt alle Entitäten mit Standorten innerhalb eines GeoJSON-Polygons zurück. Unterstützt komplexe Formen mit Löchern. Nützlich für jurisdiktionsbasierte Filterung.

Auth erforderlich
GET
/api/v1/geo/clusters

Standort-Cluster abrufen

Gibt geclusterte Standortdaten zurück, die für Kartendarstellung auf verschiedenen Zoom-Stufen optimiert sind. Verwendet räumliche Clustering-Algorithmen zur Aggregation naher Punkte.

Auth erforderlich
GET
/api/v1/geo/heatmap

Heatmap-Daten abrufen

Gibt Dichtedaten für Heatmap-Visualisierung zurück. Aggregiert Entitätsstandorte in Rasterzellen mit Anzahl und gewichteten Werten. Konfigurierbare Rasterauflösung.

Auth erforderlich
POST
/api/v1/geo/route

Route berechnen

Berechnet optimale Route zwischen Standorten unter Berücksichtigung realer Straßennetze. Gibt Polylinien-Geometrie, Entfernung, geschätzte Dauer und Abbiegehinweise zurück.

Auth erforderlich
GET
/api/v1/geo/timeline/{entity_id}

Standort-Timeline abrufen

Gibt chronologischen Standortverlauf für eine Entität zurück. Zeigt Bewegungsmuster über Zeit. Nützlich für Tracking-Ermittlungen und Musteranalyse.

Auth erforderlich
POST
/api/v1/geo/geocode

Geocode Address

Konvertiert eine Textadresse in geografische Koordinaten. Gibt mehrere Kandidaten mit Konfidenzwerten zurück. Unterstützt internationale Adressen in mehreren Sprachen.

Auth erforderlich
POST
/api/v1/geo/reverse-geocode

Reverse Geocode

Konvertiert Koordinaten in eine menschenlesbare Adresse. Gibt strukturierte Adresskomponenten (Straße, Stadt, Land) und Ortsnamen auf verschiedenen Präzisionsstufen zurück.

Auth erforderlich

Dashboards & Visualisierung

Erstellen Sie anpassbare Dashboards mit Diagrammen, Karten, Metriken und gemeinsamen Teamansichten.

POST
/api/v1/dashboards

Erstellen Dashboard

Erstellt ein neues Dashboard mit Titel, Beschreibung und Layout-Konfiguration. Dashboards können persönlich oder mit Teams geteilt werden. Gibt Dashboard-ID zum Hinzufügen von Panels zurück.

Auth erforderlich
GET
/api/v1/dashboards/{dashboard_id}

Abrufen Dashboard

Gibt Dashboard-Konfiguration zurück, einschließlich aller Panels, Layout, Filter und Refresh-Einstellungen. Optional vorberechnete Panel-Daten für sofortiges Rendering.

Auth erforderlich
PUT
/api/v1/dashboards/{dashboard_id}

Aktualisieren Dashboard

Aktualisiert Dashboard-Metadaten oder Layout-Konfiguration. Unterstützt Panel-Neuordnung und Größenänderung. Löst Aktualisierung betroffener Panels aus.

Auth erforderlich
DELETE
/api/v1/dashboards/{dashboard_id}

Löschen Dashboard

Löscht ein Dashboard und alle seine Panels. Geteilte Dashboards erfordern Eigentümerberechtigung zum Löschen. Favorisierte Dashboards zeigen Warnung vor Löschung.

Auth erforderlich
GET
/api/v1/dashboards

Auflisten Dashboards

Gibt alle für den Benutzer zugänglichen Dashboards zurück, einschließlich eigener, geteilter und Team-Dashboards. Unterstützt Filterung nach Typ und Favoriten.

Auth erforderlich
POST
/api/v1/dashboards/{dashboard_id}/panels

Panel zum Dashboard hinzufügen

Fügt ein neues Panel (Diagramm, Tabelle, Metrik, Karte) zu einem Dashboard hinzu. Konfiguriert Datenquelle, Abfrage, Visualisierungstyp und Position im Layout.

Auth erforderlich
PUT
/api/v1/dashboards/{dashboard_id}/panels/{panel_id}

Aktualisieren Panel

Aktualisiert Panel-Konfiguration einschließlich Abfrage, Visualisierungseinstellungen und Position. Änderungen lösen sofortige Datenaktualisierung aus.

Auth erforderlich
DELETE
/api/v1/dashboards/{dashboard_id}/panels/{panel_id}

Löschen Panel

Entfernt ein Panel von einem Dashboard. Andere Panels fließen automatisch um, um Platz basierend auf Layout-Modus zu füllen.

Auth erforderlich
POST
/api/v1/dashboards/{dashboard_id}/share

Dashboard teilen

Teilt ein Dashboard mit bestimmten Benutzern oder Teams. Konfigurieren Sie Nur-Ansicht- oder Bearbeitungsberechtigungen. Optional öffentlichen Link für externes Teilen generieren.

Auth erforderlich
POST
/api/v1/dashboards/{dashboard_id}/clone

Dashboard klonen

Erstellt eine Kopie eines Dashboards mit allen Panels. Nützlich zum Erstellen von Variationen oder persönlichen Kopien von Team-Dashboards.

Auth erforderlich

Berichte & Exporte

Generieren Sie professionelle Berichte, Gerichtspakete und Datenexporte in mehreren Formaten.

POST
/api/v1/reports/generate

Generieren Bericht

Generiert einen Bericht aus einer Vorlage oder benutzerdefinierten Konfiguration. Unterstützt mehrere Ausgabeformate (PDF, DOCX, HTML, XLSX). Gibt Berichts-ID für Status-Polling und Download zurück.

Auth erforderlich
GET
/api/v1/reports/{report_id}

Abrufen Bericht

Gibt Berichtsmetadaten zurück, einschließlich Generierungsstatus, verwendeter Parameter und Download-Links, wenn abgeschlossen. Große Berichte können mehrere Minuten zur Generierung benötigen.

Auth erforderlich
GET
/api/v1/reports/{report_id}/download

Bericht herunterladen

Lädt eine generierte Berichtsdatei herunter. Unterstützt Range-Requests für große Dateien. Zugriff wird zur Audit-Compliance protokolliert.

Auth erforderlich
GET
/api/v1/reports

Auflisten Berichte

Gibt alle vom Benutzer oder Team generierten Berichte zurück. Unterstützt Filterung nach Vorlage, Datumsbereich und Status. Enthält Generierungsmetadaten und Dateigröße.

Auth erforderlich
DELETE
/api/v1/reports/{report_id}

Löschen Bericht

Löscht eine generierte Berichtsdatei. Berichtsmetadaten werden für Audit aufbewahrt. Kann keine Berichte löschen, die für Legal Hold markiert sind.

Auth erforderlich
POST
/api/v1/exports/case/{case_id}

Vorgang exportieren

Exportiert ein vollständiges Vorgangpaket einschließlich aller Daten, Notizen, Anhänge und Timeline. Unterstützt Schwärzung sensibler Felder. Gibt Download-Link zurück, wenn bereit.

Auth erforderlich
POST
/api/v1/exports/investigation/{investigation_id}

Ermittlung exportieren

Exportiert eine vollständige Ermittlung mit allen Vorgängen, Profilen und Beweisen. Große Ermittlungen werden asynchron mit Fortschrittsbenachrichtigungen verarbeitet.

Auth erforderlich
POST
/api/v1/exports/court-package

Gerichtspaket generieren

Generiert ein gerichtsfertiges Beweispaket mit ordnungsgemäßer Chain-of-Custody-Dokumentation, Exponatnummerierung und rechtlicher Formatierung. Enthält Integritätszertifikate.

Auth erforderlich
GET
/api/v1/reports/templates

Berichtsvorlagen auflisten

Gibt verfügbare Berichtsvorlagen zurück, einschließlich integrierter und benutzerdefinierter Vorlagen. Vorlagen definieren Layout, Datenquellen und konfigurierbare Parameter.

Auth erforderlich
POST
/api/v1/reports/schedule

Bericht planen

Plant automatische Berichtsgenerierung auf wiederkehrender Basis (täglich, wöchentlich, monatlich). Berichte werden per E-Mail zugestellt oder an angegebenem Ort gespeichert.

Auth erforderlich

Suche & Entdeckung

Globale Volltextsuche, semantische Suche und erweiterte Abfragefähigkeiten über alle Daten.

POST
/api/v1/search

Volltextsuche über alle zugänglichen Daten einschließlich Profile, Vorgänge, Notizen und Dokumente. Gibt gerankte Ergebnisse mit hervorgehobenen Übereinstimmungen und Typindikatoren zurück.

Auth erforderlich
POST
/api/v1/search/entities

Durchsuchen Entitäten

Durchsucht spezifisch Entitätsprofile mit erweiterter Filterung nach Typ, Attributen und Beziehungen. Unterstützt Fuzzy-Matching für Namen.

Auth erforderlich
POST
/api/v1/search/documents

Durchsuchen Dokumente

Durchsucht Dokumenteninhalte einschließlich PDFs, Word-Dateien und verarbeiteter Bilder. Gibt relevante Auszüge mit Match-Hervorhebung zurück.

Auth erforderlich
POST
/api/v1/search/advanced

Erweiterte Suche

Strukturierte Suche mit komplexen booleschen Abfragen, feldspezifischen Filtern, Datumsbereichen und verschachtelten Bedingungen. Unterstützt gespeicherte Abfragen für häufige Suchen.

Auth erforderlich
POST
/api/v1/search/semantic

Semantische Suche

KI-gestützte semantische Suche, die Abfrageabsicht versteht. Findet konzeptionell verwandte Inhalte auch ohne exakte Keyword-Übereinstimmungen. Ideal für Ermittlungsabfragen.

Auth erforderlich
GET
/api/v1/search/suggestions

Suchvorschläge abrufen

Gibt Autocomplete-Vorschläge zurück, während der Benutzer tippt. Enthält aktuelle Suchen, populäre Abfragen und passende Entitätsnamen für schnelle Navigation.

Auth erforderlich
GET
/api/v1/search/history

Suchverlauf abrufen

Gibt die aktuellen Suchabfragen des Benutzers mit Zeitstempeln zurück. Unterstützt Löschen des Verlaufs oder Speichern von Abfragen zur Wiederverwendung.

Auth erforderlich
POST
/api/v1/search/save

Suche speichern

Speichert eine Suchabfrage für schnellen Zugriff. Gespeicherte Suchen können mit Teammitgliedern geteilt werden. Optional Alarme konfigurieren, wenn neue Ergebnisse übereinstimmen.

Auth erforderlich

Tags & Klassifizierung

Organisieren Sie Entitäten mit Tags zur Kategorisierung, Filterung und domänenübergreifenden Entdeckung.

POST
/api/v1/tags

Erstellen Tag

Erstellt einen neuen Tag mit Name, Farbe und optionaler Beschreibung. Tags sind auf die Organisation begrenzt. Tag-Namen müssen innerhalb der Organisation eindeutig sein.

Auth erforderlich
GET
/api/v1/tags

Auflisten Tags

Gibt alle in der Organisation verfügbaren Tags mit Nutzungszählern zurück. Unterstützt Filterung nach Präfix für hierarchische Tag-Strukturen.

Auth erforderlich
PUT
/api/v1/tags/{tag_id}

Aktualisieren Tag

Aktualisiert Tag-Eigenschaften einschließlich Name, Farbe und Beschreibung. Namenänderungen werden an alle getaggten Entitäten propagiert.

Auth erforderlich
DELETE
/api/v1/tags/{tag_id}

Löschen Tag

Löscht einen Tag und entfernt ihn von allen getaggten Entitäten. Kann nicht rückgängig gemacht werden. Erwägen Sie stattdessen das Zusammenführen in einen anderen Tag.

Auth erforderlich
POST
/api/v1/tags/apply

Apply Tags

Wendet einen oder mehrere Tags auf eine Entität (Vorgang, Profil, Notiz usw.) an. Unterstützt Massen-Tagging mehrerer Entitäten. Doppelte Tags werden ignoriert.

Auth erforderlich
POST
/api/v1/tags/remove

Remove Tags

Entfernt angegebene Tags von einer Entität. Tag-Entfernung wird für Audit protokolliert. Gibt aktualisierte Tag-Liste für die Entität zurück.

Auth erforderlich
GET
/api/v1/tags/{tag_id}/entities

Entitäten nach Tag abrufen

Gibt alle Entitäten mit einem spezifischen Tag zurück. Unterstützt Filterung nach Entitätstyp. Nützlich zum Finden verwandter Elemente über verschiedene Domänen.

Auth erforderlich

Kommentare & Collaboration

Threaded-Kommentare mit Erwähnungen, Reaktionen und Echtzeit-Collaboration-Features.

POST
/api/v1/comments

Erstellen Kommentar

Erstellt einen Kommentar zu einer beliebigen Entität (Vorgang, Aufgabe, Profil usw.). Unterstützt @Erwähnungen für Benachrichtigungen und Rich-Text-Formatierung. Gibt erstellten Kommentar mit ID zurück.

Auth erforderlich
GET
/api/v1/comments/{comment_id}

Abrufen Kommentar

Gibt einen einzelnen Kommentar mit Metadaten, Antworten und Reaktionen zurück. Enthält Bearbeitungsverlauf, vorgangs Kommentar modifiziert wurde.

Auth erforderlich
PUT
/api/v1/comments/{comment_id}

Aktualisieren Kommentar

Aktualisiert Kommentarinhalt. Bearbeitungsverlauf wird aufbewahrt. Nur Kommentarautor oder Admins können bearbeiten. Benachrichtigungen werden für @Erwähnungsänderungen gesendet.

Auth erforderlich
DELETE
/api/v1/comments/{comment_id}

Löschen Kommentar

Löscht einen Kommentar. Antworten bleiben sichtbar, zeigen aber 'Parent gelöscht'. Nur Autor oder Admins können löschen. Audit-Log wird aufbewahrt.

Auth erforderlich
GET
/api/v1/{entity_type}/{entity_id}/comments

Kommentare nach Entität auflisten

Gibt alle Kommentare für eine spezifische Entität zurück. Unterstützt Thread-Ansicht mit verschachtelten Antworten. Standardmäßig nach Erstellungsdatum sortiert, neueste zuerst.

Auth erforderlich
POST
/api/v1/comments/{comment_id}/reply

Auf Kommentar antworten

Erstellt eine Thread-Antwort auf einen bestehenden Kommentar. Benachrichtigt Autor des übergeordneten Kommentars. Unterstützt unbegrenzte Verschachtelungstiefe.

Auth erforderlich
POST
/api/v1/comments/{comment_id}/react

Auf Kommentar reagieren

Fügt einem Kommentar ein Reaktions-Emoji hinzu oder entfernt es. Unterstützt Standard-Emoji-Set. Gibt aktualisierte Reaktionszähler zurück.

Auth erforderlich

Benachrichtigungen & Einstellungen

Verwalten Sie Benachrichtigungen über Kanäle mit anpassbaren Einstellungen und Ruhezeiten.

GET
/api/v1/notifications

Auflisten Benachrichtigungen

Gibt alle Benachrichtigungen für den aktuellen Benutzer zurück. Unterstützt Filterung nach Lesestatus, Typ und Datumsbereich. Sortiert nach Erstellungszeit, neueste zuerst.

Auth erforderlich
GET
/api/v1/notifications/unread-count

Anzahl ungelesener abrufen

Gibt die Anzahl ungelesener Benachrichtigungen zurück. Leichtgewichtiger Endpunkt für Badge-Anzeige. Aktualisiert sich in Echtzeit über WebSocket.

Auth erforderlich
POST
/api/v1/notifications/{notification_id}/read

Benachrichtigung als gelesen markieren

Markiert eine einzelne Benachrichtigung als gelesen. Gibt 204 No Content bei Erfolg zurück. Bereits gelesene Benachrichtigungen werden stillschweigend ignoriert.

Auth erforderlich
POST
/api/v1/notifications/mark-all-read

Alle Benachrichtigungen als gelesen markieren

Markiert alle Benachrichtigungen als gelesen. Gibt Anzahl aktualisierter Benachrichtigungen zurück. Nützlich für 'Alle löschen'-Funktionalität.

Auth erforderlich
DELETE
/api/v1/notifications/{notification_id}

Löschen Benachrichtigung

Löscht dauerhaft eine Benachrichtigung. Kann nicht rückgängig gemacht werden. Erwägen Sie stattdessen als gelesen markieren für Audit-Trail.

Auth erforderlich
GET
/api/v1/notifications/preferences

Benachrichtigungseinstellungen abrufen

Gibt Benachrichtigungseinstellungen des Benutzers zurück, einschließlich aktivierter Kanäle (E-Mail, Push, In-App), Häufigkeitseinstellungen und Konfiguration für ruhige Stunden.

Auth erforderlich
PUT
/api/v1/notifications/preferences

Benachrichtigungseinstellungen aktualisieren

Aktualisiert Benachrichtigungseinstellungen. Konfigurieren Sie, welche Ereignisse Benachrichtigungen auslösen und über welche Kanäle. Änderungen werden sofort wirksam.

Auth erforderlich

Teams & Zusammenarbeit

Teamverwaltung mit Mitgliedern, Rollen, Berechtigungen und Organisationshierarchien.

POST
/api/v1/teams

Erstellen Team

Erstellt ein neues Team mit Name, Beschreibung und initialen Mitgliedern. Team-Ersteller wird zum Standard-Eigentümer. Teams können für Organisationshierarchie verschachtelt werden.

Admin/Manager
GET
/api/v1/teams/{team_id}

Abrufen Team

Gibt Teamdetails zurück, einschließlich Mitgliedern, Rollen und Statistiken. Enthält aggregierte Metriken für Teamworkload und Performance.

Auth erforderlich
PUT
/api/v1/teams/{team_id}

Aktualisieren Team

Aktualisiert Team-Metadaten einschließlich Name, Beschreibung und Einstellungen. Nur Team-Eigentümer oder Admins können Team-Eigenschaften modifizieren.

Admin/Manager
DELETE
/api/v1/teams/{team_id}

Löschen Team

Löscht ein Team. Mitglieder werden nicht gelöscht, verlieren aber teambasierte Berechtigungen. Vorgänge und Ressourcen, die dem Team zugewiesen sind, müssen zuerst neu zugewiesen werden.

Admin/Superuser
GET
/api/v1/teams

Auflisten Teams

Gibt alle Teams zurück, die der Benutzer sehen kann. Enthält Teams, denen sie angehören, und Teams, die sie verwalten. Unterstützt Filterung nach übergeordnetem Team für Hierarchieansichten.

Auth erforderlich
POST
/api/v1/teams/{team_id}/members

Teammitglied hinzufügen

Fügt einen Benutzer mit angegebener Rolle (Mitglied, Lead, Eigentümer) zu einem Team hinzu. Benutzer erhält Benachrichtigung und erlangt sofort teambasierte Berechtigungen.

Admin/Manager
DELETE
/api/v1/teams/{team_id}/members/{user_id}

Teammitglied entfernen

Entfernt einen Benutzer aus einem Team. Benutzer verliert sofort teambasierte Berechtigungen. Kann nicht den letzten Eigentümer entfernen - übertragen Sie zuerst die Eigentümerschaft.

Admin/Manager
PUT
/api/v1/teams/{team_id}/members/{user_id}/role

Mitgliederrolle aktualisieren

Ändert die Rolle eines Teammitglieds innerhalb des Teams. Rollenänderungen wirken sich sofort auf Berechtigungen aus. Wird zur Compliance audit-protokolliert.

Admin/Manager

Watchlists & Überprüfung

Überwachen Sie Entitäten gegenüber Watchlists mit automatischem Matching und Alarmgenerierung.

POST
/api/v1/watchlists

Erstellen Watchlist

Erstellt eine neue Watchlist mit Name, Beschreibung und Matching-Kriterien. Watchlists können spezifische Entitätstypen oder Attributmuster überwachen.

Auth erforderlich
GET
/api/v1/watchlists/{watchlist_id}

Abrufen Watchlist

Gibt Watchlist-Konfiguration zurück, einschließlich Entitäten, Matching-Regeln und Statistiken. Zeigt aktuelle Match-Aktivität und Alarmeinstellungen.

Auth erforderlich
PUT
/api/v1/watchlists/{watchlist_id}

Aktualisieren Watchlist

Aktualisiert Watchlist-Konfiguration einschließlich Name, Regeln und Benachrichtigungseinstellungen. Änderungen an Regeln lösen erneute Verarbeitung aktueller Daten aus.

Auth erforderlich
DELETE
/api/v1/watchlists/{watchlist_id}

Löschen Watchlist

Löscht eine Watchlist. Historische Matches werden im Audit-Log aufbewahrt. Aktive Alarme basierend auf dieser Watchlist werden geschlossen.

Auth erforderlich
GET
/api/v1/watchlists

Auflisten Watchlists

Gibt alle für den Benutzer zugänglichen Watchlists zurück. Enthält persönliche Watchlists und geteilte Team-Watchlists. Zeigt Match-Anzahlen und letzte Aktivität.

Auth erforderlich
POST
/api/v1/watchlists/{watchlist_id}/entities

Entität zu Watchlist hinzufügen

Fügt eine spezifische Entität zur Überwachung zu einer Watchlist hinzu. Geben Sie optional Überwachungsparameter und Alarmschwellenwerte an.

Auth erforderlich
DELETE
/api/v1/watchlists/{watchlist_id}/entities/{entity_id}

Entität von Watchlist entfernen

Entfernt eine Entität aus der Watchlist-Überwachung. Bestehende Matches und Alarme werden im Verlauf aufbewahrt.

Auth erforderlich
POST
/api/v1/watchlists/{watchlist_id}/check

Gegen Watchlist prüfen

Prüft, ob eine gegebene Entität oder Daten mit Kriterien in der Watchlist übereinstimmen. Gibt übereinstimmende Regeln und Ähnlichkeitswerte zurück.

Auth erforderlich
POST
/api/v1/watchlists/batch-check

Watchlists in Batch prüfen

Prüft mehrere Entitäten gegen alle aktiven Watchlists in einer einzigen Anfrage. Effizient für Massen-Screening-Operationen. Maximum 100 Entitäten pro Anfrage.

Auth erforderlich
GET
/api/v1/watchlists/{watchlist_id}/matches

Watchlist-Matches abrufen

Gibt alle Matches für eine Watchlist mit Match-Details, Zeitstempeln und Dispositionsstatus zurück. Unterstützt Filterung nach Datumsbereich und Disposition.

Auth erforderlich

Beweisverwaltung

Gerichtszulässiges Beweis-Tracking mit Chain of Custody, Integritätsverifizierung und Versiegelung.

POST
/api/v1/evidence

Erstellen Beweis Aufzeichnen

Erstellt eine formelle Beweisaufzeichnung mit Chain-of-Custody-Tracking. Berechnet kryptografischen Hash zur Integritätsverifizierung. Weist eindeutige Beweisnummer zu.

Auth erforderlich
GET
/api/v1/evidence/{evidence_id}

Abrufen Beweis

Gibt Beweisaufzeichnung mit Metadaten, Integritätsstatus und Custody-Chain zurück. Enthält zugeordnete Anhänge und Analyseergebnisse.

Auth erforderlich
PUT
/api/v1/evidence/{evidence_id}

Aktualisieren Beweis

Aktualisiert Beweismetadaten. Inhaltsänderungen lösen neue Hash-Berechnung und Custody-Aufzeichnung aus. Versiegelte Beweise können nicht modifiziert werden.

Auth erforderlich
GET
/api/v1/cases/{case_id}/evidence

Auflisten Beweis by Vorgang

Gibt alle Beweisobjekte für einen Vorgang zurück. Unterstützt Filterung nach Typ, Status und Datum. Standardmäßig nach Erfassungsdatum sortiert.

Auth erforderlich
POST
/api/v1/evidence/{evidence_id}/custody-transfer

Custody-Übertragung aufzeichnen

Erfasst eine Custody-Übertragung von einem Verwahrer zu einem anderen. Beide Parteien müssen die Übertragung bestätigen. Erstellt unveränderliche Custody-Aufzeichnung.

Auth erforderlich
GET
/api/v1/evidence/{evidence_id}/chain-of-custody

Chain of Custody abrufen

Gibt die vollständige Chain-of-Custody-Historie für ein Beweisobjekt zurück. Zeigt jedes Custody-Ereignis mit Zeitstempeln, Verwahrern und Zwecken.

Auth erforderlich
POST
/api/v1/evidence/{evidence_id}/verify-integrity

Beweisintegrität verifizieren

Verifiziert die Beweisintegrität durch Neuberechnung des Hashes und Vergleich mit dem gespeicherten Wert. Gibt Verifizierungsergebnis mit detailliertem Vergleich zurück.

Auth erforderlich
POST
/api/v1/evidence/{evidence_id}/seal

Beweis versiegeln

Versiegelt Beweisobjekt und verhindert weitere Modifikationen. Generiert digitales Siegelzertifikat. Versiegelte Beweise können nur kopiert, nicht modifiziert werden.

Auth erforderlich
GET
/api/v1/evidence/{evidence_id}/audit-trail

Beweis-Audit-Trail abrufen

Gibt vollständigen Audit-Trail für Beweis zurück, einschließlich aller Zugriffsereignisse, Ansichten, Downloads und Analyseaktivitäten. Essentiell für gerichtliche Zulässigkeit.

Auth erforderlich

OSINT & Datenanreicherung

Abfrage mehrerer OSINT-Provider für Personen-, Organisations-, Telefon-, E-Mail-, Social-, Fahrzeug-, Domain-, IP- und Kryptowährungs-Intelligence.

GET
/api/v1/osint/providers

OSINT-Provider auflisten

Gibt alle konfigurierten OSINT-Datenanbieter mit deren Fähigkeiten, Abdeckungsbereichen und aktuellem Verfügbarkeitsstatus zurück.

Auth erforderlich
GET
/api/v1/osint/providers/{provider_id}/status

Provider-Status abrufen

Gibt detaillierten Status für einen spezifischen OSINT-Provider zurück, einschließlich API-Health, Quota-Nutzung und aktueller Performance-Metriken.

Auth erforderlich
POST
/api/v1/osint/search/person

Durchsuchen Person

Durchsucht OSINT-Quellen nach Informationen über eine Person. Akzeptiert Name, Geburtsdatum, Adressen und Identifikatoren. Aggregiert Ergebnisse von mehreren Providern.

Auth erforderlich
POST
/api/v1/osint/search/organization

Durchsuchen Organisation

Sucht nach Organisationsinformationen einschließlich Unternehmensregistern, Führungskräften, Finanzdaten und regulatorischen Einreichungen über mehrere Datenbanken.

Auth erforderlich
POST
/api/v1/osint/search/phone

Durchsuchen Telefonnummer

Rückwärtssuche für Telefonnummern über Carrier-Datenbanken, Social-Plattformen und öffentliche Aufzeichnungen. Gibt Eigentümerinformationen, Carrier-Details und verknüpfte Konten zurück.

Auth erforderlich
POST
/api/v1/osint/search/email

Durchsuchen E-Mail-Adresse

E-Mail-Intelligence-Lookup gibt Breach-Exposition, Social-Accounts und Identitätsverifizierung zurück. Unterstützt Massen-E-Mail-Validierung.

Auth erforderlich
POST
/api/v1/osint/search/social

Durchsuchen Social Media

Durchsucht Social-Media-Plattformen nach Profilen, die Kriterien entsprechen. Gibt Profil-Metadaten, Verbindungen und Inhaltsbeispiele zurück, sofern verfügbar.

Auth erforderlich
POST
/api/v1/osint/search/vehicle

Durchsuchen Fahrzeug

Fahrzeug-Lookup nach VIN, Kennzeichen oder Beschreibung. Gibt Registrierungsverlauf, Eigentümerinformationen und Vorvorgangsaufzeichnungen aus verfügbaren Datenbanken zurück.

Auth erforderlich
POST
/api/v1/osint/search/domain

Durchsuchen Domain

Domain-Intelligence einschließlich WHOIS-Verlauf, DNS-Einträgen, SSL-Zertifikaten und Hosting-Informationen. Identifiziert verwandte Domains und Infrastruktur.

Auth erforderlich
POST
/api/v1/osint/search/ip

Durchsuchen IP-Adresse

IP-Adressen-Intelligence einschließlich Geolokalisierung, ASN, Reputationswerten und Hosting-Details. Historische Daten verfügbar zur Verfolgung von Infrastrukturänderungen.

Auth erforderlich
POST
/api/v1/osint/search/crypto

Durchsuchen Kryptowährung

Kryptowährungsadressen-Analyse einschließlich Transaktionsverlauf, Cluster-Identifikation und Risikobewertung. Unterstützt Bitcoin, Ethereum und wichtige Altcoins.

Auth erforderlich
POST
/api/v1/osint/batch-enrich

Batch-Anreicherung

Reichert mehrere Entitäten mit OSINT-Daten in einer einzigen Anfrage an. Stellt Anfragen über Provider unter Berücksichtigung von Rate-Limits in die Warteschlange. Gibt Job-ID für Status-Polling zurück.

Auth erforderlich
GET
/api/v1/osint/usage

OSINT-Nutzung abrufen

Gibt OSINT-Abfragenutzungsstatistiken für die Organisation zurück, einschließlich Quota-Verbrauch nach Provider, verbleibenden Credits und Nutzungstrends.

Auth erforderlich

Vorlagen & Automation

Wiederverwendbare Vorlagen für Vorgänge, Berichte und Workflows zur Standardisierung von Prozessen.

POST
/api/v1/templates/case

Erstellen Vorgang Vorlage

Erstellt eine wiederverwendbare Vorgangvorlage mit vordefinierten Aufgaben, Checklisten, Feldern und Workflow-Phasen. Vorlagen standardisieren Ermittlungsprozesse.

Admin/Manager
GET
/api/v1/templates/case

Auflisten Vorgang Vorlagen

Gibt alle für die Organisation verfügbaren Vorgangvorlagen zurück. Enthält integrierte und benutzerdefinierte Vorlagen mit Nutzungsstatistiken.

Auth erforderlich
GET
/api/v1/templates/case/{template_id}

Abrufen Vorgang Vorlage

Gibt vollständige Vorgangvorlagen-Konfiguration zurück, einschließlich aller Abschnitte, Aufgaben und Workflow-Definitionen.

Auth erforderlich
PUT
/api/v1/templates/case/{template_id}

Aktualisieren Vorgang Vorlage

Aktualisiert Vorgangvorlagen-Konfiguration. Änderungen betreffen nicht bestehende Vorgänge, die aus der Vorlage erstellt wurden.

Admin/Manager
DELETE
/api/v1/templates/case/{template_id}

Löschen Vorgang Vorlage

Löscht eine Vorgangvorlage. Vorlage darf nicht von aktiven Workflows referenziert werden. Historische Nutzungsstatistiken werden aufbewahrt.

Admin/Superuser
POST
/api/v1/templates/report

Erstellen Bericht Vorlage

Erstellt eine Berichtsvorlage mit Layout, Abschnitten, Datenbindungen und Formatierungsregeln. Vorlagen generieren konsistente professionelle Berichte.

Admin/Manager
GET
/api/v1/templates/report

Berichtsvorlagen auflisten

Gibt alle Berichtsvorlagen zurück, einschließlich Systemvorlagen und benutzerdefinierten Organisationsvorlagen. Zeigt Vorlagenkategorien und erforderliche Parameter.

Auth erforderlich
POST
/api/v1/templates/workflow

Erstellen Workflow Vorlage

Erstellt eine Automatisierungs-Workflow-Vorlage mit Triggern, Bedingungen und Aktionen. Workflows automatisieren wiederkehrende Ermittlungsaufgaben.

Admin/Manager
GET
/api/v1/templates/workflow

Auflisten Workflow Vorlagen

Gibt alle Workflow-Vorlagen mit Ausführungsstatistiken zurück. Zeigt Trigger-Bedingungen und Aktionszusammenfassungen.

Auth erforderlich

Workflows & Automatisierung

Automatisierte Workflows mit Triggern, Bedingungen und Aktionen für Ermittlungsautomatisierung.

POST
/api/v1/workflows

Erstellen Workflow

Erstellt einen automatisierten Workflow mit definierten Triggern, Bedingungen und Aktionen. Workflows führen sich automatisch basierend auf Ereignissen oder Zeitplänen aus.

Admin/Manager
GET
/api/v1/workflows/{workflow_id}

Abrufen Workflow

Gibt Workflow-Konfiguration zurück, einschließlich aller Schritte, Bedingungen und Ausführungsverlauf. Zeigt aktuellen Status und Performance-Metriken.

Auth erforderlich
PUT
/api/v1/workflows/{workflow_id}

Aktualisieren Workflow

Aktualisiert Workflow-Konfiguration. Aktive Workflows setzen laufende Ausführungen fort; neue Trigger verwenden aktualisierte Konfiguration.

Admin/Manager
DELETE
/api/v1/workflows/{workflow_id}

Löschen Workflow

Löscht einen Workflow. Laufende Ausführungen werden abgeschlossen, aber keine neuen Ausführungen beginnen. Ausführungsverlauf wird für Audit aufbewahrt.

Admin/Superuser
GET
/api/v1/workflows

Auflisten Workflows

Gibt alle für den Benutzer zugänglichen Workflows zurück. Unterstützt Filterung nach Status, Trigger-Typ und Ausführungshäufigkeit.

Auth erforderlich
POST
/api/v1/workflows/{workflow_id}/execute

Workflow ausführen

Löst manuell eine Workflow-Ausführung mit bereitgestellten Eingabeparametern aus. Gibt Ausführungs-ID zur Überwachung des Fortschritts zurück.

Auth erforderlich
GET
/api/v1/workflows/{workflow_id}/executions

Workflow-Ausführungen auflisten

Gibt Ausführungsverlauf für einen Workflow zurück. Zeigt Status, Dauer und Outputs für jeden Lauf. Unterstützt Filterung nach Datum und Status.

Auth erforderlich
POST
/api/v1/workflows/{workflow_id}/pause

Workflow pausieren

Pausiert einen aktiven Workflow. Laufende Ausführungen werden abgeschlossen, aber neue Trigger werden in die Warteschlange gestellt. Nützlich für Wartung oder Untersuchung.

Auth erforderlich
POST
/api/v1/workflows/{workflow_id}/resume

Workflow fortsetzen

Setzt einen pausierten Workflow fort. Wartende Trigger beginnen mit der Verarbeitung. Gibt Anzahl ausstehender Ausführungen zurück.

Auth erforderlich

Echtzeitkommunikation

WebSocket-basierte Echtzeit-Messaging- und Collaboration-Endpunkte.

POST
/api/v1/channels

Erstellen Kanal

Erstellt einen Echtzeit-Messaging-Kanal für Teamzusammenarbeit. Kanäle können mit Vorgängen oder Ermittlungen verknüpft werden. Gibt Kanal-ID für WebSocket-Subscription zurück.

Auth erforderlich
GET
/api/v1/channels/{channel_id}

Abrufen Kanal

Gibt Kanaldetails zurück, einschließlich Mitgliedern, aktueller Aktivität und Konfiguration. Zeigt Anzahl ungelesener Nachrichten für den anfragenden Benutzer.

Auth erforderlich
GET
/api/v1/channels

Auflisten Channels

Gibt alle Kanäle zurück, auf die der Benutzer Zugriff hat. Enthält Direktnachrichten, Vorgang-Kanäle und Team-Kanäle. Sortiert nach aktueller Aktivität.

Auth erforderlich
POST
/api/v1/channels/{channel_id}/messages

Nachricht senden

Sendet eine Nachricht an einen Kanal. Unterstützt Text, Erwähnungen und Anhänge. Nachrichten werden in Echtzeit via WebSocket an verbundene Clients zugestellt.

Auth erforderlich
GET
/api/v1/channels/{channel_id}/messages

Kanal-Nachrichten abrufen

Gibt Nachrichtenverlauf für einen Kanal zurück. Unterstützt Paginierung zum Laden älterer Nachrichten. Enthält Reaktionen und Antwortenzähler.

Auth erforderlich
POST
/api/v1/channels/{channel_id}/members

Kanalmitglied hinzufügen

Fügt einen Benutzer zu einem Kanal hinzu. Benutzer erhält Benachrichtigung und kann Nachrichtenverlauf ab Beitrittszeitpunkt sehen. Kanaleigentümer können Mitglieder hinzufügen.

Auth erforderlich
DELETE
/api/v1/channels/{channel_id}/members/{user_id}

Kanalmitglied entfernen

Entfernt einen Benutzer aus einem Kanal. Benutzer verliert Zugriff auf Kanal und zukünftige Nachrichten. Historische Nachrichten bleiben für andere Mitglieder sichtbar.

Auth erforderlich
GET
/api/v1/users/presence

Benutzerpräsenz abrufen

Gibt Online/Offline-Status und letzte Aktivitätszeit für angegebene Benutzer oder alle Teammitglieder zurück. Aktualisiert sich in Echtzeit über WebSocket.

Auth erforderlich

GraphQL-API

Die primäre GraphQL-API (api.knogin.com/graphql) bietet 100+ Queries, 80+ Mutations und Echtzeit-Subscriptions mit dem Strawberry-GraphQL-Framework. GraphQL ermöglicht flexibles Datenabrufen, sodass Clients genau die benötigten Daten in einer einzigen Anfrage anfordern können.

GraphQL-Endpunkt

GraphQL-EndpunktPOST https://api.knogin.com/graphql
GraphQL-PlaygroundGET https://api.knogin.com/graphql

Ermittlungen

Erstellen, verwalten und verfolgen Sie Ermittlungen mit vollständiger Lifecycle-Unterstützung einschließlich Teamzuweisung, Dateiverwaltung und Fortschrittsverfolgung.

Queries
  • getInvestigation(investigationId: ID!)
  • getInvestigations(status: [Status], limit: Int, offset: Int)
  • investigationTimeline(investigationId: ID!)
  • investigationStatistics(investigationId: ID!)
  • investigationTeam(investigationId: ID!)
Mutations
  • startNewInvestigation(input: CreateInvestigationInput!)
  • updateInvestigation(investigationId: ID!, input: UpdateInvestigationInput!)
  • deleteInvestigation(investigationId: ID!)
  • addFilesToInvestigation(investigationId: ID!, fileIds: [ID!]!)
  • assignInvestigationTeam(investigationId: ID!, userIds: [ID!]!)

Vorgänge

Vollständige Vorgangverwaltung mit Vorlagen, Workflows, Statusverfolgung, Profilverlinkung und Bulk-Operationen für effiziente Vorgangbearbeitung.

Queries
  • case(caseId: ID!)
  • cases(investigationId: ID, status: [CaseStatus], priority: [Priority], limit: Int, offset: Int)
  • caseByNumber(caseNumber: String!)
  • caseTimeline(caseId: ID!)
  • caseStatistics(caseId: ID!)
  • myCases(status: [CaseStatus], limit: Int)
  • caseTemplates(category: String)
Mutations
  • createCase(input: CreateCaseInput!)
  • createCaseFromTemplate(templateId: ID!, input: CreateCaseInput!)
  • updateCase(caseId: ID!, input: UpdateCaseInput!)
  • deleteCase(caseId: ID!)
  • assignCase(caseId: ID!, userId: ID!)
  • updateCaseStatus(caseId: ID!, status: CaseStatus!)
  • linkProfileToCase(caseId: ID!, profileId: ID!, role: ProfileRole!)
  • bulkUpdateCases(caseIds: [ID!]!, input: BulkUpdateCaseInput!)

Aufgaben

Aufgabenverwaltung mit Zuweisungen, Checklisten, Abhängigkeiten und Fortschrittsverfolgung für strukturierte Ermittlungsworkflows.

Queries
  • task(taskId: ID!)
  • tasks(caseId: ID!, status: [TaskStatus], assignee: ID)
  • myTasks(status: [TaskStatus], dueDate: DateRange)
  • taskChecklist(taskId: ID!)
  • taskDependencies(taskId: ID!)
Mutations
  • createTask(input: CreateTaskInput!)
  • updateTask(taskId: ID!, input: UpdateTaskInput!)
  • deleteTask(taskId: ID!)
  • assignTask(taskId: ID!, userId: ID!)
  • completeTask(taskId: ID!, notes: String)
  • updateTaskChecklist(taskId: ID!, items: [ChecklistItemInput!]!)
  • bulkUpdateTasks(taskIds: [ID!]!, input: BulkUpdateTaskInput!)

Notizen & Anhänge

Ermittlungsnotizen mit Rich-Text, Threading und Dateianhängen. Vollständiges Chain-of-Custody-Tracking für beweisgradige Dateien.

Queries
  • note(noteId: ID!)
  • notes(caseId: ID!, type: NoteType, visibility: Visibility)
  • attachment(attachmentId: ID!)
  • attachments(caseId: ID!, fileType: String)
  • attachmentChainOfCustody(attachmentId: ID!)
Mutations
  • createNote(input: CreateNoteInput!)
  • updateNote(noteId: ID!, input: UpdateNoteInput!)
  • deleteNote(noteId: ID!)
  • replyToNote(parentNoteId: ID!, content: String!)
  • createAttachment(input: CreateAttachmentInput!)
  • deleteAttachment(attachmentId: ID!)
  • reprocessAttachment(attachmentId: ID!)

Profile & Entitäten

Entitätsprofilmanagement für Personen, Organisationen und andere Entitäten mit OSINT-Anreicherung und Beziehungsmapping.

Queries
  • getProfile(profileId: ID!)
  • listProfiles(type: ProfileType, tags: [String], limit: Int, offset: Int)
  • searchProfiles(query: String!, filters: ProfileFilters)
  • getPerson(personId: ID!)
  • listPersons(filters: PersonFilters)
  • getOrganization(orgId: ID!)
  • listOrganizations(filters: OrgFilters)
  • getEntity(entityId: ID!)
  • searchEntities(query: String!, entityTypes: [EntityType])
  • profileRelationships(profileId: ID!, depth: Int)
Mutations
  • createProfile(input: CreateProfileInput!)
  • updateProfile(profileId: ID!, input: UpdateProfileInput!)
  • deleteProfile(profileId: ID!)
  • enrichProfile(profileId: ID!, providers: [String])
  • batchEnrichProfiles(profileIds: [ID!]!, providers: [String])
  • linkProfiles(sourceId: ID!, targetId: ID!, relationType: String!)
  • unlinkProfiles(sourceId: ID!, targetId: ID!)
  • mergeProfiles(sourceIds: [ID!]!, targetId: ID!)

Alarme & Monitore

Echtzeit-Alarmsystem mit konfigurierbaren Monitoren, Schweregrad-Stufen und Entscheidungsworkflows für Bedrohungserkennung.

Queries
  • getAlertById(alertId: ID!)
  • listAlerts(severity: [Severity], status: [AlertStatus], limit: Int)
  • alertsByMonitor(monitorId: ID!, dateRange: DateRange)
  • alertStatistics(dateRange: DateRange)
  • getMonitor(monitorId: ID!)
  • listMonitors(status: MonitorStatus, type: MonitorType)
  • monitorPerformance(monitorId: ID!)
Mutations
  • createAlert(input: CreateAlertInput!)
  • updateAlert(alertId: ID!, input: UpdateAlertInput!)
  • decideAlert(alertId: ID!, decision: AlertDecision!, notes: String)
  • bulkDecideAlerts(alertIds: [ID!]!, decision: AlertDecision!)
  • createMonitor(input: CreateMonitorInput!)
  • updateMonitor(monitorId: ID!, input: UpdateMonitorInput!)
  • deleteMonitor(monitorId: ID!)
  • pauseMonitor(monitorId: ID!)
  • resumeMonitor(monitorId: ID!)

Graph-Analyse

Wissensgraph-Operationen einschließlich Pfadfindung, Zentralitätsanalyse, Community-Erkennung und Link-Vorhersage für Netzwerk-Intelligence.

Queries
  • graphNode(nodeId: ID!)
  • graphNeighbors(nodeId: ID!, depth: Int, relationTypes: [String])
  • findPath(sourceId: ID!, targetId: ID!, maxDepth: Int)
  • shortestPath(sourceId: ID!, targetId: ID!)
  • subgraph(seedIds: [ID!]!, depth: Int)
  • graphStatistics(investigationId: ID)
  • centrality(nodeIds: [ID!]!, algorithm: CentralityAlgorithm)
  • communities(investigationId: ID!, algorithm: CommunityAlgorithm)
  • linkPrediction(nodeId: ID!, limit: Int)
Mutations
  • createGraphNode(input: CreateNodeInput!)
  • updateGraphNode(nodeId: ID!, input: UpdateNodeInput!)
  • deleteGraphNode(nodeId: ID!)
  • createGraphEdge(input: CreateEdgeInput!)
  • updateGraphEdge(edgeId: ID!, input: UpdateEdgeInput!)
  • deleteGraphEdge(edgeId: ID!)
  • mergeNodes(sourceIds: [ID!]!, targetId: ID!)

Geospatial Intelligence

Standortbasierte Abfragen, Clustering, Heatmaps, Geofencing und Timeline-Analyse für geografische Intelligence-Operationen.

Queries
  • getLocation(locationId: ID!)
  • listLocations(bounds: BoundingBox, entityType: EntityType)
  • entitiesWithinBounds(bounds: BoundingBox!, filters: GeoFilters)
  • entitiesWithinRadius(center: LatLng!, radiusKm: Float!)
  • entitiesWithinPolygon(polygon: GeoJSONPolygon!)
  • locationClusters(bounds: BoundingBox!, zoomLevel: Int!)
  • heatmapData(bounds: BoundingBox!, resolution: Int)
  • locationTimeline(entityId: ID!, dateRange: DateRange)
  • geocode(address: String!)
  • reverseGeocode(coordinates: LatLng!)
Mutations
  • createLocation(input: CreateLocationInput!)
  • updateLocation(locationId: ID!, input: UpdateLocationInput!)
  • deleteLocation(locationId: ID!)
  • linkLocationToEntity(locationId: ID!, entityId: ID!)
  • createGeofence(input: CreateGeofenceInput!)
  • updateGeofence(geofenceId: ID!, input: UpdateGeofenceInput!)

Dashboards & Visualisierung

Erstellen und verwalten Sie anpassbare Dashboards mit Panels, Diagrammen und Echtzeit-Metriken für operative Awareness.

Queries
  • getDashboard(dashboardId: ID!)
  • listDashboards(type: DashboardType, shared: Boolean)
  • getDashboardMetrics(dashboardId: ID!)
  • panelData(panelId: ID!, dateRange: DateRange)
  • dashboardTemplates(category: String)
Mutations
  • createDashboard(input: CreateDashboardInput!)
  • updateDashboard(dashboardId: ID!, input: UpdateDashboardInput!)
  • deleteDashboard(dashboardId: ID!)
  • addPanelToDashboard(dashboardId: ID!, input: PanelInput!)
  • updatePanel(panelId: ID!, input: UpdatePanelInput!)
  • deletePanel(panelId: ID!)
  • shareDashboard(dashboardId: ID!, userIds: [ID!]!)
  • cloneDashboard(dashboardId: ID!, newName: String!)

Suche & Entdeckung

Globale Suche mit semantischen Fähigkeiten, erweiterten Filtern und gespeicherten Abfragen für schnelle Intelligence-Entdeckung.

Queries
  • globalSearch(query: String!, limit: Int, offset: Int)
  • semanticSearch(query: String!, entityTypes: [EntityType])
  • advancedSearch(input: AdvancedSearchInput!)
  • searchSuggestions(prefix: String!, limit: Int)
  • searchHistory(limit: Int)
  • savedSearches
Mutations
  • saveSearch(input: SaveSearchInput!)
  • deleteSavedSearch(searchId: ID!)
  • clearSearchHistory

Beweisverwaltung

Gerichtszulässiges Beweis-Tracking mit Chain of Custody, Integritätsverifizierung und Versiegelung für Gerichtsverfahren.

Queries
  • evidence(evidenceId: ID!)
  • evidenceByCase(caseId: ID!, type: EvidenceType)
  • evidenceChainOfCustody(evidenceId: ID!)
  • verifyEvidenceIntegrity(evidenceId: ID!)
  • evidenceAuditTrail(evidenceId: ID!)
Mutations
  • createEvidence(input: CreateEvidenceInput!)
  • updateEvidence(evidenceId: ID!, input: UpdateEvidenceInput!)
  • recordCustodyTransfer(evidenceId: ID!, input: CustodyTransferInput!)
  • sealEvidence(evidenceId: ID!)
  • linkEvidenceToCase(evidenceId: ID!, caseId: ID!)

OSINT & Anreicherung

Open-Source-Intelligence-Abfragen über mehrere Provider für Personen-, Organisations-, Telefon-, E-Mail-, Social-Media-, Fahrzeug-, Domain-, IP- und Kryptowährungsdaten.

Queries
  • osintProviders
  • osintProviderStatus(providerId: ID!)
  • osintUsage(dateRange: DateRange)
Mutations
  • searchPerson(input: PersonSearchInput!)
  • searchOrganization(input: OrgSearchInput!)
  • searchPhone(phoneNumber: String!, providers: [String])
  • searchEmail(email: String!, providers: [String])
  • searchSocialMedia(input: SocialSearchInput!)
  • searchVehicle(input: VehicleSearchInput!)
  • searchDomain(domain: String!)
  • searchIP(ipAddress: String!)
  • searchCrypto(address: String!, blockchain: String!)
  • batchEnrich(entityIds: [ID!]!, providers: [String])

Teams & Benutzer

Teamverwaltung mit Mitgliederrollen, Berechtigungen und Hierarchien für kollaborative Ermittlungsoperationen.

Queries
  • team(teamId: ID!)
  • teams(parentId: ID)
  • teamMembers(teamId: ID!)
  • myTeams
  • user(userId: ID!)
  • users(role: Role, status: UserStatus)
  • currentUser
Mutations
  • createTeam(input: CreateTeamInput!)
  • updateTeam(teamId: ID!, input: UpdateTeamInput!)
  • deleteTeam(teamId: ID!)
  • addTeamMember(teamId: ID!, userId: ID!, role: TeamRole!)
  • removeTeamMember(teamId: ID!, userId: ID!)
  • updateTeamMemberRole(teamId: ID!, userId: ID!, role: TeamRole!)

Workflows & Automation

Automatisierte Workflows mit Triggern, Bedingungen und Aktionen für optimierte Ermittlungsprozesse.

Queries
  • workflow(workflowId: ID!)
  • workflows(status: WorkflowStatus, trigger: TriggerType)
  • workflowExecutions(workflowId: ID!, status: ExecutionStatus)
  • workflowExecution(executionId: ID!)
  • workflowTemplates(category: String)
Mutations
  • createWorkflow(input: CreateWorkflowInput!)
  • updateWorkflow(workflowId: ID!, input: UpdateWorkflowInput!)
  • deleteWorkflow(workflowId: ID!)
  • executeWorkflow(workflowId: ID!, input: JSON)
  • pauseWorkflow(workflowId: ID!)
  • resumeWorkflow(workflowId: ID!)
  • cancelExecution(executionId: ID!)

KI-Services

KI-gestützte Textanalyse, Entitätsextraktion, Zusammenfassung, Übersetzung und Dokumentenverarbeitungsfähigkeiten.

Queries
  • aiProcessingStatus(jobId: ID!)
  • aiProcessingHistory(entityId: ID!)
  • aiCapabilities
Mutations
  • analyzeText(text: String!, options: AnalysisOptions)
  • extractEntities(text: String!, entityTypes: [EntityType])
  • generateSummary(text: String!, style: SummaryStyle)
  • translateText(text: String!, targetLanguage: String!)
  • generateGraph(text: String!)
  • processDocument(fileId: ID!, options: ProcessingOptions)
  • processImage(fileId: ID!, options: ImageProcessingOptions)
  • processAudio(fileId: ID!, options: AudioProcessingOptions)
  • processVideo(fileId: ID!, options: VideoProcessingOptions)

Benachrichtigungen & Kommentare

Echtzeit-Benachrichtigungen mit Einstellungen, Threaded-Kommentare, Erwähnungen und Reaktionen für Teamzusammenarbeit.

Queries
  • notifications(status: NotificationStatus, limit: Int)
  • unreadNotificationCount
  • notificationPreferences
  • comments(entityId: ID!, entityType: EntityType)
  • comment(commentId: ID!)
Mutations
  • markNotificationRead(notificationId: ID!)
  • markAllNotificationsRead
  • updateNotificationPreferences(input: NotificationPreferencesInput!)
  • createComment(input: CreateCommentInput!)
  • updateComment(commentId: ID!, content: String!)
  • deleteComment(commentId: ID!)
  • replyToComment(parentId: ID!, content: String!)
  • reactToComment(commentId: ID!, reaction: String!)

Echtzeit-Subscriptions

Abonnieren Sie Echtzeit-Updates über WebSocket für Live-Datenstreaming über alle Domänen.

Alarme
  • alertStream
  • alertUpdates(alertId: ID!)
  • monitorAlerts(monitorId: ID!)
Ermittlungen
  • investigationProgress(investigationId: ID!)
  • caseUpdates(caseId: ID!)
  • taskUpdates(caseId: ID!)
Dashboards
  • dashboardUpdates(dashboardId: ID!)
  • panelData(panelId: ID!)
  • metricsStream(dashboardId: ID!)
Collaboration
  • channelMessages(channelId: ID!)
  • userPresence(userIds: [ID!]!)
  • typingIndicator(channelId: ID!)
Verarbeitung
  • processingProgress(jobId: ID!)
  • enrichmentProgress(profileId: ID!)
  • workflowExecution(executionId: ID!)
Benachrichtigungen
  • notificationStream
  • mentionStream
  • systemAnnouncements

Beispiel: Ermittlung mit Vorgängen abfragen

GraphQL Query
query GetInvestigationWithCases($investigationId: ID!) {
  getInvestigation(investigationId: $investigationId) {
    id
    title
    status
    createdAt
    profiles {
      id
      name
      type
      riskScore
    }
  }
  cases(investigationId: $investigationId) {
    id
    title
    status
    priority
    assignedTo {
      id
      displayName
    }
    tasks {
      id
      title
      status
      dueDate
    }
  }
}

Beispiel: Alarm-Mutation erstellen

GraphQL Mutation
mutation CreateAlert($input: CreateAlertInput!) {
  createAlert(input: $input) {
    id
    title
    severity
    confidence
    createdAt
    entities {
      id
      name
      type
    }
  }
}

# Variables
{
  "input": {
    "title": "Suspicious Activity Detected",
    "summary": "Multiple failed login attempts from unusual location",
    "severity": "HIGH",
    "confidence": 0.85,
    "entities": ["entity-123"],
    "monitorId": "monitor-456"
  }
}

WebSocket & Echtzeit

Echtzeitkommunikation über WebSocket für Live-Updates, GraphQL-Subscriptions und Collaboration-Features.

WebSocket-Endpunkte

WS
wss://api.knogin.com/graphql

GraphQL Subscriptions

WebSocket-Endpunkt für GraphQL-Subscriptions unter Verwendung des graphql-ws-Protokolls. Unterstützt alle Subscription-Operationen einschließlich Alarm-Streams, Ermittlungs-Updates und Echtzeit-Collaboration.

Auth erforderlich
WS
wss://api.knogin.com/ws

General Event Stream

WebSocket-Endpunkt für allgemeines Echtzeit-Event-Streaming einschließlich Ermittlungs-Updates, Systembenachrichtigungen und Benutzerpрäsenz. Unterstützt kanalbasierte Subscriptions.

Auth erforderlich

Subscription-Beispiel

GraphQL Subscription
subscription AlertStream {
  alertStream {
    id
    title
    severity
    confidence
    createdAt
    entities {
      id
      name
    }
    locations {
      latitude
      longitude
    }
  }
}

Antwortformate

Standard-Antwortstrukturen, die in der gesamten API verwendet werden.

Erfolgsantwort

{
  "success": true,
  "data": { ... },
  "message": "Operation completed successfully",
  "timestamp": "2024-01-15T10:30:00Z",
  "request_id": "req_abc123"
}

Fehlerantwort

{
  "error": "VALIDATION_ERROR",
  "message": "Invalid input parameters",
  "code": "ERR_VALIDATION_001",
  "details": {
    "field": "email",
    "reason": "Invalid email format"
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

HTTP-Statuscodes

Häufige Statuscodes, die von der API zurückgegeben werden.

  • 200OK - Anfrage erfolgreich
  • 201Created - Ressource erstellt
  • 204No Content - Erfolg ohne Body
  • 400Bad Request - Ungültige Parameter
  • 401Unauthorized - Authentifizierung erforderlich
  • 403Forbidden - Zugriff verweigert
  • 404Not Found - Ressource nicht gefunden
  • 422Unprocessable Entity - Validierungsfehler
  • 429Too Many Requests - Rate-limitiert
  • 500Interner Serverfehler

Rate-Limits

API-Rate-Limits zur Gewährleistung fairer Nutzung und Systemstabilität.

  • Standard-Endpunkte1000 Anfragen pro Minute
  • Authentifizierungsendpunkte5 Anfragen pro Minute (Login, MFA-Verifizierung)
  • Batch-Operationen100 Profile pro Batch-Anfrage, 10 für Anreicherung
  • Datei-Uploads50MB maximale Dateigröße
  • KI-VerarbeitungUnterliegt Token-Limits pro Organisations-Tier

Bereit zur Integration?

Beginnen Sie mit unseren SDKs oder kontaktieren Sie unser Integrationsteam für Unterstützung.