Pular para o conteúdo principal

API de PINs

GET /v1/pins/:pinCode/results

A API de PINs permite obter de forma programática os resultados de scan dos seus próprios PINs. Útil para criar bots do Discord, ferramentas de automação e integrações personalizadas. Para acompanhar o progresso do scan em tempo real, consulte a API de status do PIN.

URL base
https://api.anticheat.ac/v1
Autenticação
Requer chave de API com a permissão pins:results

Obter resultados do PIN

Obtenha os resultados de scan de um PIN específico. Você só pode acessar resultados de PINs que são seus (criados pela sua conta). Retorna dados de detecção, incluindo detecções, itens suspeitos, avisos, verificações de integridade e metadados básicos do scan.

GET/v1/pins/:pinCode/results

Parâmetros

NomeTipoDescrição
pinCodestringO código do PIN de 8 caracteres (por exemplo, A7K3M2P9P9)

Cabeçalhos

x-api-key: your_api_key_here

Resposta (scan concluído)

{
  "pin": "A7K3M2P9P9",
  "type": "Java",
  "status": "finished",
  "result": "cheating",
  "pinName": "Tournament Match #42",
  "data": {
    "cheating": "cheating",
    "detections": [
      "Generic Cheat Loader - Detection",
      "Process Injection - javaw.exe"
    ],
    "suspicious": [
      "Modified game files detected"
    ],
    "warnings": [
      "Multiple Minecraft instances detected"
    ],
    "untrusted": [],
    "integrity": [
      "System file tampered: kernel32.dll"
    ],
    "customSuspicious": [],
    "vpn": "No",
    "country": "US",
    "logon": "2h 30m",
    "scantime": "45 seconds",
    "windows": "Windows 11 Pro 23H2",
    "discord": [
      { "id": "123456789012345678", "username": "player123" }
    ]
  },
  "createdAt": "2024-01-15T10:30:00.000Z"
}

Resposta (pendente/em andamento)

{
  "pin": "A7K3M2P9",
  "type": "Java",
  "status": "pending",
  "result": "none",
  "pinName": "Tournament Match #42",
  "message": "Pin is waiting for scan to start"
}

Respostas de erro

StatusCódigoDescrição
400Requisição inválidaO código do PIN está vazio ou é inválido
403ProibidoO PIN não pertence à sua conta
404Não encontradoO código do PIN não existe

Campos de dados

CampoTipoDescrição
cheatingstring | nullVeredito geral de uso de cheats
detectionsarrayLista de detecções de cheats confirmadas
suspiciousarrayLista de achados suspeitos
warningsarrayLista de sinalizações de aviso
untrustedarrayLista de itens não confiáveis
integrityarrayLista de resultados das verificações de integridade
customSuspiciousarrayDetecções suspeitas personalizadas a partir das suas palavras-chave configuradas
vpnstring | nullStatus da detecção de VPN
countrystring | nullPaís do usuário escaneado
logonstring | nullDuração da sessão/tempo ligado do sistema
scantimestring | nullQuanto tempo o scan levou
windowsstring | nullInformações da versão do Windows
discordarrayContas do Discord detectadas no sistema escaneado. Cada entrada tem id (ID de usuário do Discord) e username

É necessário ser o proprietário

Você só pode consultar resultados de PINs criados pela sua própria conta. Tentar acessar o PIN de outro usuário retorna um erro 403 Forbidden.

Proteção de privacidade

Informações sensíveis como HWID, IP do servidor, contas alternativas e identificadores internos nunca são expostas por este endpoint, para proteger a privacidade dos usuários.

Status do PIN

StatusDescrição
pendingPIN criado, aguardando o início do scan
scanningO scan está em andamento
finishedScan concluído, resultados disponíveis
expiredO PIN expirou antes de o scan ser concluído
errorOcorreu um erro durante o scan

Exemplo de uso

cURL

curl -X GET "https://api.anticheat.ac/v1/pins/A7K3M2P9/results" \
  -H "x-api-key: your_api_key_here"

JavaScript / Node.js

const response = await fetch('https://api.anticheat.ac/v1/pins/A7K3M2P9/results', {
  headers: { 'x-api-key': 'your_api_key_here' }
});

const data = await response.json();

if (data.status === 'finished') {
  console.log('Result:', data.result);
  console.log('Detections:', data.data.detections);
  console.log('Suspicious:', data.data.suspicious);
} else {
  console.log('Status:', data.status, '-', data.message);
}

Python

import requests

response = requests.get(
    'https://api.anticheat.ac/v1/pins/A7K3M2P9/results',
    headers={'x-api-key': 'your_api_key_here'}
)

data = response.json()

if data['status'] == 'finished':
    print(f"Result: {data['result']}")
    print(f"Detections: {data['data']['detections']}")
else:
    print(f"Status: {data['status']} - {data.get('message', '')}")

Consultar até terminar (JavaScript)

async function waitForResults(pinCode, apiKey) {
  const url = 'https://api.anticheat.ac/v1/pins/' + pinCode + '/results';
  const headers = { 'x-api-key': apiKey };

  while (true) {
    const res = await fetch(url, { headers });
    const data = await res.json();

    if (data.status === 'finished') return data;
    if (data.status === 'expired' || data.status === 'error') {
      throw new Error('Scan ' + data.status + ': ' + (data.message || ''));
    }

    await new Promise(r => setTimeout(r, 5000));
  }
}

const results = await waitForResults('A7K3M2P9', 'your_api_key_here');
console.log(results.data);