API przeskanowanych użytkowników pozwala pobrać pełne informacje o użytkowniku: historię skanowań, wykrycia, status bana/ostrzeżenia i powiązane konta.

Bazowy URL: https://api.anticheat.ac/v1
Uwierzytelnianie: Wymagany klucz API z uprawnieniem scanned-users:lookup
Wymaga: Aktywna licencja lub członkostwo w Enterprise

Wyszukaj użytkownika po ID Discord

Pobierz pełne informacje o użytkowniku Discord, w tym historię skanowań, wykrycia, status bana/ostrzeżenia i potencjalnie powiązane konta.

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

Parametry

Nazwa	Typ	Opis
discordId	string	ID użytkownika Discord do wyszukania

Nagłówki

x-api-key: your_api_key_here

Odpowiedź

{
  "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"
      ]
    }
  ]
}

Pola odpowiedzi

Pole	Typ	Opis
found	boolean	Wskazuje, czy użytkownik został znaleziony w bazie
discordId	string	ID użytkownika Discord
username	string	Aktualna nazwa użytkownika
totalScans	number	Łączna liczba skanowań tego użytkownika
totalDetections	number	Łączna liczba znalezionych wykryć
overallStatus	string	Status ogólny: `clean`, `suspicious`, `cheating`, lub `banned`
isBanned	boolean	Czy któryś powiązany HWID jest obecnie zbanowany
isWarned	boolean	Czy któryś powiązany HWID ma aktywne ostrzeżenie
bans	array	Lista aktywnych banów/ostrzeżeń ze statusem, powodem, datą wygaśnięcia i datą utworzenia
detections	array	Lista wszystkich unikalnych znalezionych wykryć
reasons	array	Ręczne powody/notatki dodane przez staff lub automatycznie przez system
firstSeen	string	Znacznik czasu ISO 8601 pierwszego skanowania
lastSeen	string	Znacznik czasu ISO 8601 ostatniego skanowania
gamesScanned	array	Lista gier, w których użytkownik był skanowany (np. Java, FiveM, Bedrock)
totalHwids	number	Liczba unikalnych HWID powiązanych z tym użytkownikiem
hasRelatedAccounts	boolean	Wskazuje, czy wykryto potencjalnie powiązane konta
totalRelatedAccounts	number	Liczba wykrytych powiązanych kont
relatedAccounts	array	Lista potencjalnie powiązanych kont wykrytych przez systemy Ocean do wykrywania multikont

Obiekt banów

Pole	Typ	Opis
status	string	`banned`, `warned`, lub `expired`
reason	string	Powód bana lub ostrzeżenia
isExpired	boolean	Czy ban/ostrzeżenie wygasło
createdAt	string	Znacznik czasu ISO 8601 utworzenia bana/ostrzeżenia

Obiekt powiązanych kont

Pole	Typ	Opis
discordId	string	ID Discord powiązanego konta
username	string	Nazwa użytkownika powiązanego konta
sharedHwidIds	array	ID wspólnych HWID łączących konta
totalDetections	number	Łączna liczba wykryć na powiązanym koncie
overallStatus	string	Status powiązanego konta
lastSeenAt	string	Ostatni raz, gdy to powiązane konto było skanowane
detections	array	Wykrycia znalezione na powiązanym koncie

Odpowiedź, gdy nie znaleziono użytkownika

Gdy użytkownik nie zostanie znaleziony w bazie, API zwraca następującą odpowiedź:

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

Bezpieczeństwo i prywatność

Wykrywanie multikont

Ocean używa zaawansowanych systemów wykrywania do identyfikacji potencjalnie powiązanych kont. Gdy wykryte zostaną powiązania między kontami, są one automatycznie łączone, a do ich profili w czasie rzeczywistym podczas skanowania dodawane są notatki.

Ochrona prywatności

Wrażliwe metody wykrywania i identyfikatory techniczne (HWID, IP) nigdy nie są udostępniane przez API, aby chronić prywatność użytkowników i integralność naszych systemów wykrywania.

Przykład użycia

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'])}")

Limity żądań

Żądania do API mają limit, aby zapewnić uczciwe użycie i stabilność systemu. Aktualny globalny limit to:

Globalny limit żądań

1000 żądań na godzinę na klucz API

Jeśli potrzebujesz wyższych limitów dla swojej integracji, skontaktuj się z naszym zespołem wsparcia.

Nagłówki limitów są dołączane do każdej odpowiedzi:

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