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
| 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);