API statusu PIN-u

Pobierz status PIN-u

Pobierz aktualny status skanowania konkretnego PIN-u, w tym procent postępu i komunikat statusu. Masz dostęp tylko do statusu PIN-ów, których jesteś właścicielem (utworzonych przez Twoje konto). Po zakończeniu skanowania odpowiedź zawiera też podsumowanie wyników z liczbą wykryć.

GET/v1/pins/:pinCode/status

Parametry

Nagłówki

x-api-key: your_api_key_here

Odpowiedź (oczekujące)

{
  "pin": "A7K3M2P9",
  "pinName": "Tournament Match #42",
  "type": "Java",
  "status": "pending",
  "progress": 0,
  "statusMessage": null,
  "result": null,
  "used": false,
  "lastStatusUpdate": null,
  "createdAt": "2026-02-11T15:25:00.000Z",
  "isFinished": false,
  "isScanning": false,
  "isPending": true
}

Odpowiedź (skanowanie w toku)

{
  "pin": "A7K3M2P9",
  "pinName": "Tournament Match #42",
  "type": "Java",
  "status": "scanning",
  "progress": 45,
  "statusMessage": "Scanning system files... (45%)",
  "result": null,
  "used": true,
  "lastStatusUpdate": "2026-02-11T15:30:00.000Z",
  "createdAt": "2026-02-11T15:25:00.000Z",
  "isFinished": false,
  "isScanning": true,
  "isPending": false
}

Odpowiedź (zakończone)

Po zakończeniu skanowania odpowiedź zawiera obiekt data z podsumowaniem liczby wykryć. Pełne szczegóły wykryć znajdziesz w endpoincie wyników PIN-u.

{
  "pin": "A7K3M2P9",
  "pinName": "Tournament Match #42",
  "type": "Java",
  "status": "finished",
  "progress": 100,
  "statusMessage": "Scan completed",
  "result": "cheating",
  "used": true,
  "lastStatusUpdate": "2026-02-11T15:35:00.000Z",
  "createdAt": "2026-02-11T15:25:00.000Z",
  "isFinished": true,
  "isScanning": false,
  "isPending": false,
  "data": {
    "cheating": "cheating",
    "vpn": "No",
    "country": "US",
    "scantime": "45 seconds",
    "windows": "Windows 11 Pro 23H2",
    "detectionsCount": 3,
    "warningsCount": 1,
    "suspiciousCount": 2,
    "discord": [
      { "id": "123456789012345678", "username": "player123" }
    ]
  }
}

Pola odpowiedzi

Pola data (tylko po zakończeniu)

Odpowiedzi z błędem

Strategia odpytywania

Ponieważ skanowanie trwa, powinieneś odpytywać ten endpoint cyklicznie, aby śledzić postęp. Zalecane strategie:

Przykład użycia

cURL

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

JavaScript / Node.js

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

const data = await response.json();

console.log('Status:', data.status);
console.log('Progress:', data.progress + '%');
console.log('Message:', data.statusMessage);

if (data.isFinished) {
  console.log('Result:', data.result);
  console.log('Detections:', data.data.detectionsCount);
}

Python

import requests

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

data = response.json()

print(f"Status: {data['status']}")
print(f"Progress: {data['progress']}%")
print(f"Message: {data.get('statusMessage', 'N/A')}")

if data['isFinished']:
    print(f"Result: {data['result']}")
    print(f"Detections: {data['data']['detectionsCount']}")

Odpytywanie z paskiem postępu (JavaScript)

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

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

    onProgress({
      status: data.status,
      progress: data.progress,
      message: data.statusMessage,
    });

    if (data.isFinished) return data;

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

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

const result = await pollPinStatus('A7K3M2P9', 'your_api_key_here', (info) => {
  console.log('[' + info.progress + '%] ' + info.message);
});

console.log('Final result:', result.result);
console.log('Detections:', result.data.detectionsCount);

Przykład bota Discord (discord.js)

const { EmbedBuilder } = require('discord.js');

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

  const embed = new EmbedBuilder()
    .setTitle('Scan: ' + pinCode)
    .setDescription('Starting scan...')
    .setColor(0x3498db);

  const msg = await channel.send({ embeds: [embed] });

  const interval = setInterval(async () => {
    try {
      const res = await fetch(url, { headers });
      const data = await res.json();

      const bar = '\u2588'.repeat(Math.floor(data.progress / 5))
        + '\u2591'.repeat(20 - Math.floor(data.progress / 5));

      embed.setDescription(
        bar + ' ' + data.progress + '%\n'
        + (data.statusMessage || 'Waiting...')
      );

      if (data.isFinished) {
        clearInterval(interval);
        embed.setColor(data.result === 'legit' ? 0x2ecc71 : 0xe74c3c);
        embed.addFields(
          { name: 'Result', value: data.result, inline: true },
          { name: 'Detections', value: String(data.data.detectionsCount), inline: true },
          { name: 'Warnings', value: String(data.data.warningsCount), inline: true },
        );
      }

      await msg.edit({ embeds: [embed] });
    } catch (err) {
      clearInterval(interval);
      embed.setDescription('Error: ' + err.message).setColor(0xe74c3c);
      await msg.edit({ embeds: [embed] });
    }
  }, 5000);
}