Mit der Scanned-Users-API kannst du vollständige Nutzerinformationen abfragen, darunter Scan-Verlauf, Erkennungen, Bann-/Warnstatus und verwandte Konten.

Basis-URL: https://api.anticheat.ac/v1
Authentifizierung: API-Schlüssel erforderlich mit scanned-users:lookup
Erfordert: Aktive Lizenz oder Enterprise-Mitgliedschaft

Nutzer per Discord-ID nachschlagen

Rufe vollständige Informationen zu einem Discord-Nutzer ab, darunter Scan-Verlauf, Erkennungen, Bann-/Warnstatus und möglicherweise verwandte Konten.

GET/v1/scanned-users/lookup/:discordId

Parameter

Name	Typ	Beschreibung
discordId	string	Die nachzuschlagende Discord-Nutzer-ID

Header

x-api-key: your_api_key_here

Antwort

{
  "found": true,
  "discordId": "123456789012345678",
  "username": "PlayerUsername",
  "totalScans": 5,
  "totalDetections": 3,
  "overallStatus": "cheating",
  "isBanned": true,
  "isWarned": false,
  "bans": [
    {
      "status": "banned",
      "reason": "Cheating detected - Generic Loader",
      "isExpired": false,
      "createdAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "detections": [
    "Generic Cheat Loader - Detection",
    "Process Injection - FiveM.exe"
  ],
  "reasons": [
    {
      "reason": "⚠️ Possible alt account detected: AltAccount (987654321)",
      "category": "suspicious",
      "addedAt": "2024-01-15T10:30:00.000Z",
      "evidence": null
    }
  ],
  "firstSeen": "2024-01-10T08:00:00.000Z",
  "lastSeen": "2024-01-20T15:45:00.000Z",
  "gamesScanned": ["Java", "FiveM"],
  "totalHwids": 2,
  "hasRelatedAccounts": true,
  "totalRelatedAccounts": 1,
  "relatedAccounts": [
    {
      "discordId": "987654321098765432",
      "username": "AltAccount",
      "sharedHwidIds": [1],
      "totalDetections": 5,
      "overallStatus": "cheating",
      "lastSeenAt": "2024-01-18T12:00:00.000Z",
      "detections": [
        "System Hooking - svchost.exe",
        "Generic Packed File - cheat.exe"
      ]
    }
  ]
}

Antwortfelder

Feld	Typ	Beschreibung
found	boolean	Zeigt an, ob der Nutzer in der Datenbank gefunden wurde
discordId	string	Die Discord-Nutzer-ID
username	string	Aktueller Benutzername
totalScans	number	Gesamtzahl der bei diesem Nutzer durchgeführten Scans
totalDetections	number	Gesamtzahl der gefundenen Erkennungen
overallStatus	string	Gesamtstatus: `clean`, `suspicious`, `cheating`, oder `banned`
isBanned	boolean	Ob ein verknüpfter HWID aktuell gebannt ist
isWarned	boolean	Ob ein verknüpfter HWID eine aktive Warnung hat
bans	array	Liste aktiver Banns/Warnungen mit Status, Grund, Ablauf und Erstellungsdatum
detections	array	Liste aller eindeutigen gefundenen Erkennungen
reasons	array	Manuelle Gründe/Notizen, die vom Staff oder automatisch vom System hinzugefügt wurden
firstSeen	string	ISO-8601-Zeitstempel des ersten Scans
lastSeen	string	ISO-8601-Zeitstempel des letzten Scans
gamesScanned	array	Liste der Spiele, in denen der Nutzer gescannt wurde (z. B. Java, FiveM, Bedrock)
totalHwids	number	Anzahl der eindeutigen HWIDs, die mit diesem Nutzer verknüpft sind
hasRelatedAccounts	boolean	Zeigt an, ob möglicherweise verwandte Konten erkannt wurden
totalRelatedAccounts	number	Anzahl der erkannten verwandten Konten
relatedAccounts	array	Liste möglicherweise verwandter Konten, die von den Multi-Accounting-Erkennungssystemen von Ocean erkannt wurden

Bans-Objekt

Feld	Typ	Beschreibung
status	string	`banned`, `warned`, oder `expired`
reason	string	Grund für den Bann oder die Warnung
isExpired	boolean	Ob der Bann/die Warnung abgelaufen ist
createdAt	string	ISO-8601-Zeitstempel der Erstellung des Banns/der Warnung

Objekt verwandter Konten

Feld	Typ	Beschreibung
discordId	string	Discord-ID des verwandten Kontos
username	string	Benutzername des verwandten Kontos
sharedHwidIds	array	IDs der gemeinsamen HWIDs, die die Konten verbinden
totalDetections	number	Gesamtzahl der Erkennungen beim verwandten Konto
overallStatus	string	Status des verwandten Kontos
lastSeenAt	string	Zeitpunkt, zu dem dieses verwandte Konto zuletzt gescannt wurde
detections	array	Beim verwandten Konto gefundene Erkennungen

Antwort bei nicht gefundenem Nutzer

Wenn ein Nutzer nicht in der Datenbank gefunden wird, gibt die API folgende Antwort zurück:

{
  "found": false,
  "discordId": "123456789012345678",
  "message": "User not found in scan database",
  "relatedAccounts": []
}

Sicherheit & Datenschutz

Multi-Account-Erkennung

Ocean nutzt fortschrittliche Erkennungssysteme, um möglicherweise verwandte Konten zu identifizieren. Werden Verbindungen zwischen Konten erkannt, werden sie automatisch verknüpft und es werden in Echtzeit während des Scans Notizen zu ihren Profilen hinzugefügt.

Datenschutz

Sensible Erkennungsmethoden und technische Kennungen (HWIDs, IPs) werden über die API nie offengelegt, um die Privatsphäre der Nutzer zu schützen und die Integrität unserer Erkennungssysteme zu wahren.

Anwendungsbeispiel

cURL

curl -X GET "https://api.anticheat.ac/v1/scanned-users/lookup/123456789012345678" \
  -H "x-api-key: your_api_key_here"

JavaScript/Node.js

const response = await fetch(
  'https://api.anticheat.ac/v1/scanned-users/lookup/123456789012345678',
  {
    headers: {
      'x-api-key': 'your_api_key_here'
    }
  }
);

const data = await response.json();

if (data.found) {
  console.log('Status:', data.overallStatus);
  console.log('Banned:', data.isBanned);
  console.log('Detections:', data.detections.length);
  console.log('Related accounts:', data.totalRelatedAccounts);
}

Python

import requests

headers = {
    'x-api-key': 'your_api_key_here'
}

response = requests.get(
    'https://api.anticheat.ac/v1/scanned-users/lookup/123456789012345678',
    headers=headers
)

data = response.json()

if data['found']:
    print(f"Status: {data['overallStatus']}")
    print(f"Banned: {data['isBanned']}")
    print(f"Games: {', '.join(data['gamesScanned'])}")

Rate-Limiting

API-Anfragen sind ratenbegrenzt, um faire Nutzung und Systemstabilität zu gewährleisten. Das aktuelle globale Rate-Limit beträgt:

Globales Rate-Limit

1.000 Anfragen pro Stunde pro API-Schlüssel

Wenn du für deine Integration höhere Rate-Limits benötigst, wende dich bitte an unser Support-Team.

Rate-Limit-Header sind in jeder Antwort enthalten:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200