Pular para o conteúdo principal

API de usuários escaneados

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

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

Buscar usuário por ID do Discord

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.

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

Parâmetros

NomeTipoDescrição
discordIdstringO ID de usuário do Discord a ser consultado

Cabeçalhos

x-api-key: your_api_key_here

Resposta

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

Campos da resposta

CampoTipoDescrição
foundbooleanIndica se o usuário foi encontrado no banco de dados
discordIdstringO ID de usuário do Discord
usernamestringNome de usuário atual
totalScansnumberNúmero total de scans realizados neste usuário
totalDetectionsnumberNúmero total de detecções encontradas
overallStatusstringStatus geral: clean, suspicious, cheating, ou banned
isBannedbooleanIndica se algum HWID vinculado está banido no momento
isWarnedbooleanIndica se algum HWID vinculado tem um aviso ativo
bansarrayLista de bans/avisos ativos com status, motivo, expiração e data de criação
detectionsarrayLista de todas as detecções únicas encontradas
reasonsarrayMotivos/notas manuais adicionados pela equipe ou automaticamente pelo sistema
firstSeenstringTimestamp ISO 8601 do primeiro scan
lastSeenstringTimestamp ISO 8601 do último scan
gamesScannedarrayLista de jogos em que o usuário foi escaneado (por exemplo, Java, FiveM, Bedrock)
totalHwidsnumberNúmero de HWIDs únicos vinculados a este usuário
hasRelatedAccountsbooleanIndica se foram detectadas contas possivelmente relacionadas
totalRelatedAccountsnumberNúmero de contas relacionadas detectadas
relatedAccountsarrayLista de contas possivelmente relacionadas detectadas pelos sistemas de detecção de múltiplas contas do Ocean

Objeto de bans

CampoTipoDescrição
statusstringbanned, warned, ou expired
reasonstringMotivo do ban ou do aviso
isExpiredbooleanIndica se o ban/aviso expirou
createdAtstringTimestamp ISO 8601 de quando o ban/aviso foi criado

Objeto de contas relacionadas

CampoTipoDescrição
discordIdstringID do Discord da conta relacionada
usernamestringNome de usuário da conta relacionada
sharedHwidIdsarrayIDs dos HWIDs compartilhados que vinculam as contas
totalDetectionsnumberTotal de detecções na conta relacionada
overallStatusstringStatus da conta relacionada
lastSeenAtstringÚltima vez que esta conta relacionada foi escaneada
detectionsarrayDetecções encontradas na conta relacionada

Resposta de usuário não encontrado

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": []
}

Segurança e privacidade

Detecção de múltiplas contas

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.

Proteção de privacidade

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.

Exemplo de uso

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

Limite de requisições

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