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

Nome	Tipo	Descrição
pinCode	string	O 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

Status	Código	Descrição
`400`	Requisição inválida	O código do PIN está vazio ou é inválido
`403`	Proibido	O PIN não pertence à sua conta
`404`	Não encontrado	O código do PIN não existe

Campos de dados

Campo	Tipo	Descrição
cheating	string \| null	Veredito geral de uso de cheats
detections	array	Lista de detecções de cheats confirmadas
suspicious	array	Lista de achados suspeitos
warnings	array	Lista de sinalizações de aviso
untrusted	array	Lista de itens não confiáveis
integrity	array	Lista de resultados das verificações de integridade
customSuspicious	array	Detecções suspeitas personalizadas a partir das suas palavras-chave configuradas
vpn	string \| null	Status da detecção de VPN
country	string \| null	País do usuário escaneado
logon	string \| null	Duração da sessão/tempo ligado do sistema
scantime	string \| null	Quanto tempo o scan levou
windows	string \| null	Informações da versão do Windows
discord	array	Contas 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

Status	Descrição
`pending`	PIN criado, aguardando o início do scan
`scanning`	O scan está em andamento
`finished`	Scan concluído, resultados disponíveis
`expired`	O PIN expirou antes de o scan ser concluído
`error`	Ocorreu 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);