Pular para o conteúdo principal

API de pontuação de risco do usuário

GET /v1/users/:discordId/risk-score

Obtenha a pontuação de risco calculada de um usuário do Discord. A pontuação de risco agrega histórico de scans, detecções e análise comportamental de todos os perfis vinculados.

URL base
https://api.anticheat.ac/v1
Autenticação
Requer chave de API com a permissão user:risk-score
Requer
Licença ativa ou participação em um Enterprise

Obter pontuação de risco por ID do Discord

Retorna a maior pontuação de risco encontrada entre todos os perfis vinculados ao usuário do Discord, junto com estatísticas agregadas de scans.

GET/v1/users/:discordId/risk-score

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",
  "riskScore": 78,
  "riskLevel": "high",
  "linkedProfiles": 2,
  "stats": {
    "totalScans": 12,
    "cheatingScans": 4,
    "suspiciousScans": 3,
    "cleanScans": 5,
    "totalDetections": 15
  },
  "uniqueCheatsDetected": [
    "Generic Cheat Loader",
    "Process Injection",
    "Memory Manipulation"
  ],
  "isBanned": false,
  "firstScanDate": "2024-01-10T08:00:00.000Z",
  "lastScanDate": "2024-02-01T14:30:00.000Z",
  "lastCheatingDate": "2024-01-28T12:00:00.000Z"
}

Campos da resposta

CampoTipoDescrição
riskScorenumberPontuação de risco de 0 a 100 (a maior entre os perfis vinculados)
riskLevelstringclean, low, medium, high, ou critical
linkedProfilesnumberNúmero de perfis de risco vinculados a este usuário do Discord
statsobjectEstatísticas agregadas de scans de todos os perfis vinculados
uniqueCheatsDetectedarrayLista de nomes únicos de cheats detectados em todos os scans
isBannedbooleanIndica se algum perfil vinculado está banido no momento

Níveis de risco

NívelFaixa de pontuaçãoDescrição
clean0Nenhuma detecção ou atividade suspeita
low1 - 25Sinalizações menores, provavelmente falsos positivos
medium26 - 50Alguma atividade suspeita detectada
high51 - 75Várias detecções, provavelmente uso de cheats
critical76 - 100Uso de cheats confirmado, com amplo histórico de detecções

Exemplo de uso

cURL

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

JavaScript/Node.js

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

const data = await response.json();

if (data.riskScore >= 75) {
  console.log('High risk user! Level:', data.riskLevel);
}