User-Risk-Score-API
GET /v1/users/:discordId/risk-score
Rufe den berechneten Risikowert für einen Discord-Nutzer ab. Der Risikowert fasst Scan-Verlauf, Erkennungen und Verhaltensanalyse über alle verknüpften Profile zusammen.
- Basis-URL
https://api.anticheat.ac/v1- Authentifizierung
- API-Schlüssel erforderlich mit
user:risk-score - Erfordert
- Aktive Lizenz oder Enterprise-Mitgliedschaft
Risikowert per Discord-ID abrufen
Gibt den höchsten Risikowert aller mit dem Discord-Nutzer verknüpften Profile zurück, zusammen mit aggregierten Scan-Statistiken.
GET/v1/users/:discordId/risk-score
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
| discordId | string | Die abzufragende Discord-Nutzer-ID |
Header
x-api-key: your_api_key_here
Antwort
{
"found": true,
"discordId": "123456789012345678",
"riskScore": 78,
"riskLevel": "high",
"linkedProfiles": 2,
"stats": {
"totalScans": 12,
"cheatingScans": 4,
"suspiciousScans": 3,
"cleanScans": 5,
"totalDetections": 15
},
"uniqueCheatsDetected": [
"Generic Cheat Loader",
"Process Injection",
"Memory Manipulation"
],
"isBanned": false,
"firstScanDate": "2024-01-10T08:00:00.000Z",
"lastScanDate": "2024-02-01T14:30:00.000Z",
"lastCheatingDate": "2024-01-28T12:00:00.000Z"
}Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
| riskScore | number | Risikowert von 0 bis 100 (höchster Wert über verknüpfte Profile) |
| riskLevel | string | clean, low, medium, high, oder critical |
| linkedProfiles | number | Anzahl der mit diesem Discord-Nutzer verknüpften Risikoprofile |
| stats | object | Aggregierte Scan-Statistiken über alle verknüpften Profile |
| uniqueCheatsDetected | array | Liste der eindeutigen Cheat-Namen, die in allen Scans erkannt wurden |
| isBanned | boolean | Ob ein verknüpftes Profil aktuell gebannt ist |
Risikostufen
| Stufe | Punktebereich | Beschreibung |
|---|---|---|
clean | 0 | Keine Erkennungen oder verdächtigen Aktivitäten |
low | 1 - 25 | Geringfügige Flags, wahrscheinlich Fehlalarme |
medium | 26 - 50 | Einige verdächtige Aktivitäten erkannt |
high | 51 - 75 | Mehrere Erkennungen, wahrscheinlich Cheating |
critical | 76 - 100 | Bestätigtes Cheating mit umfangreichem Erkennungsverlauf |
Anwendungsbeispiel
cURL
curl -X GET "https://api.anticheat.ac/v1/users/123456789012345678/risk-score" \ -H "x-api-key: your_api_key_here"
JavaScript/Node.js
const response = await fetch(
'https://api.anticheat.ac/v1/users/123456789012345678/risk-score',
{ headers: { 'x-api-key': 'your_api_key_here' } }
);
const data = await response.json();
if (data.riskScore >= 75) {
console.log('High risk user! Level:', data.riskLevel);
}