A API de usuários escaneados permite consultar informações completas de um usuário, incluindo histórico de scans, detecções, status de ban/aviso e contas relacionadas.
URL base: https://api.anticheat.ac/v1
Autenticação: Requer chave de API com a permissão scanned-users:lookup
Requer: Licença ativa ou participação em um Enterprise
Obtenha informações completas sobre um usuário do Discord, incluindo histórico de scans, detecções, status de ban/aviso e possíveis contas relacionadas.
/v1/scanned-users/lookup/:discordId| Nome | Tipo | Descrição |
|---|---|---|
| discordId | string | O ID de usuário do Discord a ser consultado |
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 | Descrição |
|---|---|---|
| found | boolean | Indica se o usuário foi encontrado no banco de dados |
| discordId | string | O ID de usuário do Discord |
| username | string | Nome de usuário atual |
| totalScans | number | Número total de scans realizados neste usuário |
| totalDetections | number | Número total de detecções encontradas |
| overallStatus | string | Status geral: clean, suspicious, cheating, ou banned |
| isBanned | boolean | Indica se algum HWID vinculado está banido no momento |
| isWarned | boolean | Indica se algum HWID vinculado tem um aviso ativo |
| bans | array | Lista de bans/avisos ativos com status, motivo, expiração e data de criação |
| detections | array | Lista de todas as detecções únicas encontradas |
| reasons | array | Motivos/notas manuais adicionados pela equipe ou automaticamente pelo sistema |
| firstSeen | string | Timestamp ISO 8601 do primeiro scan |
| lastSeen | string | Timestamp ISO 8601 do último scan |
| gamesScanned | array | Lista de jogos em que o usuário foi escaneado (por exemplo, Java, FiveM, Bedrock) |
| totalHwids | number | Número de HWIDs únicos vinculados a este usuário |
| hasRelatedAccounts | boolean | Indica se foram detectadas contas possivelmente relacionadas |
| totalRelatedAccounts | number | Número de contas relacionadas detectadas |
| relatedAccounts | array | Lista de contas possivelmente relacionadas detectadas pelos sistemas de detecção de múltiplas contas do Ocean |
| Campo | Tipo | Descrição |
|---|---|---|
| status | string | banned, warned, ou expired |
| reason | string | Motivo do ban ou do aviso |
| isExpired | boolean | Indica se o ban/aviso expirou |
| createdAt | string | Timestamp ISO 8601 de quando o ban/aviso foi criado |
| Campo | Tipo | Descrição |
|---|---|---|
| discordId | string | ID do Discord da conta relacionada |
| username | string | Nome de usuário da conta relacionada |
| sharedHwidIds | array | IDs dos HWIDs compartilhados que vinculam as contas |
| totalDetections | number | Total de detecções na conta relacionada |
| overallStatus | string | Status da conta relacionada |
| lastSeenAt | string | Última vez que esta conta relacionada foi escaneada |
| detections | array | Detecções encontradas na conta relacionada |
Quando um usuário não é encontrado no banco de dados, a API retorna a seguinte resposta:
{
"found": false,
"discordId": "123456789012345678",
"message": "User not found in scan database",
"relatedAccounts": []
}O Ocean usa sistemas de detecção avançados para identificar contas possivelmente relacionadas. Quando conexões entre contas são detectadas, elas são vinculadas automaticamente e notas são adicionadas aos perfis em tempo real durante o scan.
Métodos de detecção sensíveis e identificadores técnicos (HWIDs, IPs) nunca são expostos pela API, para proteger a privacidade dos usuários e manter a integridade dos nossos sistemas de detecção.
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'])}")As requisições à API têm limite de taxa para garantir um uso justo e a estabilidade do sistema. O limite global atual é:
Limite global
1.000 requisições por hora por chave de API
Se você precisa de limites maiores para a sua integração, entre em contato com nossa equipe de suporte.
Os cabeçalhos de limite são incluídos em todas as respostas:
X-RateLimit-Limit: 1000 X-RateLimit-Remaining: 999 X-RateLimit-Reset: 1640995200