Dokumentation

Fälle mit Paginierung und Filterung auflisten

Query Parameters:
  limit    - Number of results (default: 25, max: 100)
  offset   - Pagination offset
  status   - Filter: pending, in_review, confirmed, cleared, appealed
  search   - Search by Steam ID or player name
  sort     - Sort field: created_at, final_score, status
  order    - Sort order: asc, desc

Neuen Fall erstellen und Scan-Token generieren

Body: {
  "player_id": "steam:...",
  "player_name": "Player",
  "reason_type": "suspicious_activity",
  "scan_scope": "full"
}
Response: { id, token, scan_url }

Einzelnen Fall per ID abrufen

Response: { id, steam_id, player_name, final_score, status, ... }

Fall-Status aktualisieren

Body: { "status": "confirmed" | "cleared" | "in_review" | "appealed" }

Fall einem Analysten zuweisen

Body: { "analyst_id": "uuid" }

Neuen Scan-Token für bestehenden Fall generieren

Response: { token, expires_at, scan_url }

Fall löschen

Response: 204 No Content

Aggregierte Fall-Statistiken abrufen

Response: { total, pending, confirmed, cleared, ... }

Mehrere Fälle gleichzeitig löschen

Body: { "case_ids": ["uuid1", "uuid2"] }

Fälle nach Status massenhaft bereinigen

Body: { "status": "pending" }

Scan-Bericht einreichen (Agent → Server)

Body: {
  "token": "scan-token-here",
  "result_json": { ... },
  "score_components": "yara:20,hash:10",
  "final_score": 30
}

Berichte für einen Fall auflisten

Response: { reports: [...] }

Aktuelle Tenant-Infos und Live-Zähler abrufen

Response: { id, name, slug, plan, member_count, case_count, ... }

Tenant-Einstellungen aktualisieren (Name, Akzentfarbe, Einstellungen)

Body: { "name": "My Community", "accent_color": "#5865F2", "settings": {} }

Teammitglieder auflisten

Response: { members: [{ user_id, username, role, ... }] }

Teammitglied hinzufügen

Body: { "user_id": "uuid", "role": "analyst" }

Teammitglied entfernen

Response: 204 No Content

Tenant-Server auflisten

Response: { servers: [{ id, name, game }] }

Server hinzufügen

Body: { "name": "Server 1", "game": "fivem" }

API-Keys auflisten

Response: { api_keys: [{ id, name, prefix, created_at }] }

Neuen API-Key erstellen

Body: { "name": "My API Key" }
Response: { key: "sk_..." }

API-Key löschen

Response: 204 No Content

Tenant Audit-Log einsehen

Query: limit, offset
Response: { entries: [{ action, actor, created_at, details }] }

Aktuelle Plan-Details und Nutzung abrufen

Response: { plan, limits, usage, features }

Dashboard-Statistiken abrufen (Fälle, Scans, Trends)

Response: { total_cases, total_scans, confirmed_rate, trends, ... }

Erweiterte Analysen mit detaillierten Aufschlüsselungen (Enterprise)

Response: { ... detailed breakdowns by server, time, detection type }

Statistiken der Erkennungs-Engine (Regel-Treffer, Trefferquoten)

Response: { rule_matches, hit_rates, top_rules, ... }

Hash-Reputations-Statistiken

Response: { total_hashes, malicious, benign, unknown }

Aktuelle globale Bewertungsgewichte abrufen

Response: { weights: { yara: 30, hash_deny: 25, loader: 20, keyword: 10, ... } }

Bewertungs-Feedback für einen Fall einreichen, um die Genauigkeit zu verbessern

Body: {
  "case_id": "uuid",
  "scanner_score": 75,
  "analyst_score": 90,
  "scanner_verdict": "suspicious",
  "analyst_verdict": "confirmed",
  "feedback_type": "score_correction"
}

Per-Finding Feedback einreichen (Falsch-Positiv / Bestätigt)

Body: {
  "code": "YARA_MATCH",
  "path": "C:\\...",
  "case_id": "uuid",
  "action": "false_positive" | "confirmed"
}

Aktuelle YARA-Regeln abrufen

Response: { rules: "rule ... { ... }" }

YARA-Regeln aktualisieren

Body: { "rules": "rule ... { ... }" }

Regel-Versionshistorie einsehen

Query: type=yara
Response: { versions: [{ id, created_at, type }] }

Regeln live gegen einen Bericht testen

Body: { "report": { ... } }
Response: { matches: [...], score: 42 }

Threat-Intel-Quellen auflisten (eigene + globale)

Response: { sources: [{ id, name, source_type, url, last_synced }] }

Threat-Intel-Einträge auflisten

Query: limit, source_id
Response: { items: [...] }

Neue Threat-Intel-Quelle hinzufügen

Body: { "name": "My Intel", "source_type": "yara_repo", "url": "https://..." }

Bestimmte Intel-Quelle synchronisieren

Response: { synced_items: 42 }

Alle aktiven Intel-Quellen synchronisieren

Response: { queued: true }

Whitelist-Einträge auflisten (nach Typ filtern)

Query: type=hash|process|player
Response: { entries: [...] }

Whitelist-Eintrag hinzufügen

Body: { "entry_type": "hash", "value": "abc123...", "reason": "Known safe" }

Whitelist-Eintrag entfernen

Response: 204 No Content

Spieler-Historie per Discord-ID, Lizenz oder Spieler-ID nachschlagen

Query: discord_id | license | player_id
Response: { history: [{ case_id, status, score, created_at }] }

Massen-Scan-Warteschlange auflisten

Response: { queue: [{ id, player_id, status, created_at }] }

Spieler zur Warteschlange hinzufügen

Body: { "player_id": "steam:...", "discord_id": "123", "license": "abc" }

Warteschlangen-Element aktualisieren

Body: { "status": "completed" }

Spieler aus der Warteschlange entfernen

Response: 204 No Content