La API de usuarios escaneados permite consultar la información completa de un usuario: historial de escaneos, detecciones, bans o avisos y cuentas relacionadas.
URL base: https://api.anticheat.ac/v1
Autenticación: Se requiere una clave de API con el permiso scanned-users:lookup
Requiere: Licencia activa o membresía de Enterprise
Obtén la información completa de un usuario de Discord: historial de escaneos, detecciones, bans o avisos y posibles cuentas relacionadas.
/v1/scanned-users/lookup/:discordId| Nombre | Tipo | Descripción |
|---|---|---|
| discordId | string | El ID de Discord del usuario a consultar |
x-api-key: your_api_key_here{
"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"
]
}
]
}| Campo | Tipo | Descripción |
|---|---|---|
| found | boolean | Indica si el usuario está en la base de datos |
| discordId | string | El ID de usuario de Discord |
| username | string | Nombre de usuario actual |
| totalScans | number | Cantidad total de escaneos de este usuario |
| totalDetections | number | Cantidad total de detecciones |
| overallStatus | string | Estado general: clean, suspicious, cheating, o banned |
| isBanned | boolean | Si algún HWID vinculado está baneado ahora |
| isWarned | boolean | Si algún HWID vinculado tiene un aviso activo |
| bans | array | Lista de bans y avisos activos, con estado, motivo, caducidad y fecha de creación |
| detections | array | Lista de todas las detecciones únicas encontradas |
| reasons | array | Motivos o notas añadidos por el staff o de forma automática por el sistema |
| firstSeen | string | Marca de tiempo ISO 8601 del primer escaneo |
| lastSeen | string | Marca de tiempo ISO 8601 del último escaneo |
| gamesScanned | array | Juegos en los que se escaneó al usuario (por ejemplo Java, FiveM, Bedrock) |
| totalHwids | number | Cantidad de HWID únicos vinculados a este usuario |
| hasRelatedAccounts | boolean | Indica si se detectaron posibles cuentas relacionadas |
| totalRelatedAccounts | number | Cantidad de cuentas relacionadas detectadas |
| relatedAccounts | array | Lista de posibles cuentas relacionadas detectadas por los sistemas de multicuenta de Ocean |
| Campo | Tipo | Descripción |
|---|---|---|
| status | string | banned, warned, o expired |
| reason | string | Motivo del ban o del aviso |
| isExpired | boolean | Si el ban o el aviso ya caducó |
| createdAt | string | Marca de tiempo ISO 8601 de creación del ban o aviso |
| Campo | Tipo | Descripción |
|---|---|---|
| discordId | string | ID de Discord de la cuenta relacionada |
| username | string | Nombre de usuario de la cuenta relacionada |
| sharedHwidIds | array | IDs de los HWID compartidos que vinculan las cuentas |
| totalDetections | number | Detecciones totales de la cuenta relacionada |
| overallStatus | string | Estado de la cuenta relacionada |
| lastSeenAt | string | Última vez que se escaneó esta cuenta relacionada |
| detections | array | Detecciones encontradas en la cuenta relacionada |
Si el usuario no está en la base de datos, la API responde así:
{
"found": false,
"discordId": "123456789012345678",
"message": "User not found in scan database",
"relatedAccounts": []
}Ocean usa sistemas de detección avanzados para identificar posibles cuentas relacionadas. Cuando detecta vínculos, las une y añade notas a sus perfiles en tiempo real durante el escaneo.
Los métodos de detección sensibles y los identificadores técnicos (HWID, IP) nunca se exponen por la API, para proteger la privacidad y la integridad de los sistemas de detección.
curl -X GET "https://api.anticheat.ac/v1/scanned-users/lookup/123456789012345678" \ -H "x-api-key: your_api_key_here"
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);
}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'])}")Las peticiones a la API tienen límite para un uso justo y la estabilidad del sistema. El límite global actual es:
Límite global
1.000 peticiones por hora por clave de API
Si tu integración necesita un límite más alto, contacta al equipo de soporte.
Todas las respuestas incluyen las cabeceras del límite:
X-RateLimit-Limit: 1000 X-RateLimit-Remaining: 999 X-RateLimit-Reset: 1640995200