API de criação de PINs
POST /v1/pins/create
A API de criação de PINs permite que proprietários de Enterprise criem PINs de scan de forma programática. Ideal para automatizar fluxos de screenshare, integrações com bots do Discord e sistemas de gerenciamento de torneios.
- URL base
https://api.anticheat.ac/v1- Autenticação
- Requer chave de API com a permissão
pins:create
Somente proprietários de Enterprise
Este endpoint está disponível exclusivamente para proprietários de Enterprise. Usuários comuns com licenças pagas ou membros de um Enterprise não podem usar este recurso. Você precisa ser dono de um Enterprise ativo para criar chaves de API com a permissão pins:create.
Criar PIN
Cria um novo PIN de scan para um tipo de jogo específico. Um PIN sem uso expira em 24 horas. Você pode, opcionalmente, definir o PIN como privado (acessível somente por você) ou público (visível na sua organização).
POST/v1/pins/create
Cabeçalhos
x-api-key: your_api_key_here Content-Type: application/json
Corpo da requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| type | string | Sim | Tipo de jogo do scan |
| pinName | string | Não | Nome personalizado do PIN (máximo de 50 caracteres) |
| ramDump | boolean | Não | Ativa a análise de dump de RAM (padrão: false) |
| private | boolean | Não | Define o PIN como privado (padrão: false). PINs privados são visíveis somente para você. |
Tipos de jogo válidos
- Java
- Bedrock
- FiveM
- RedM
- RageMP
- AltV
- Roblox
- SanAndreas
- Cod
- Rust
Exemplo de requisição
{
"type": "Java",
"pinName": "Tournament Match #42",
"ramDump": false,
"private": true
}Resposta (sucesso)
{
"pin": "A7K3M2P9",
"type": "Java",
"status": "pending",
"pinName": "Tournament Match #42",
"ramDump": false,
"private": true,
"expiresAt": "2026-02-12T15:25:00.000Z",
"createdAt": "2026-02-11T15:25:00.000Z",
"enterprise": "My Organization"
}Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
| pin | string | O código do PIN gerado, com 8 caracteres |
| type | string | O tipo de jogo |
| status | string | Status inicial (sempre "pending") |
| pinName | string | null | Nome personalizado atribuído ao PIN |
| ramDump | boolean | Indica se o dump de RAM está ativado |
| private | boolean | Indica se o PIN é privado |
| expiresAt | string | Timestamp ISO 8601 de quando o PIN expira (24 horas sem uso) |
| createdAt | string | Timestamp ISO 8601 de quando o PIN foi criado |
| enterprise | string | Nome do Enterprise ao qual o PIN pertence |
Respostas de erro
| Status | Código | Descrição |
|---|---|---|
400 | Requisição inválida | Tipo de jogo inválido |
403 | Proibido | A conta está banida ou o usuário não é proprietário de um Enterprise |
404 | Não encontrado | Usuário associado à chave de API não encontrado |
Visibilidade do PIN
Quando private é true, o PIN e seus resultados ficam visíveis somente para você. Quando é false (padrão), outros membros do seu Enterprise podem ver o PIN no painel da organização.
Dica de fluxo
Depois de criar um PIN, use a API de status de PIN para acompanhar o progresso do scan e a API de resultados de PIN para obter os detalhes completos das detecções quando o scan terminar. Status do PIN · PINs
Limites
| Limite | Valor |
|---|---|
| PINs ativos ao mesmo tempo | 3 (pending + scanning) |
| Expiração do PIN | 24 horas após a criação, se não for usado |
| Tamanho do nome do PIN | 50 caracteres no máximo |
| Limite de requisições da API | 1.000 requisições por hora (compartilhadas com todos os endpoints) |
Exemplo de uso
cURL
curl -X POST "https://api.anticheat.ac/v1/pins/create" \
-H "x-api-key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"type": "Java", "pinName": "Match #42", "private": true}'JavaScript / Node.js
const response = await fetch('https://api.anticheat.ac/v1/pins/create', {
method: 'POST',
headers: {
'x-api-key': 'your_api_key_here',
'Content-Type': 'application/json',
},
body: JSON.stringify({
type: 'Java',
pinName: 'Match #42',
private: true,
}),
});
const data = await response.json();
console.log('Pin created:', data.pin);
console.log('Expires at:', data.expiresAt);Python
import requests
response = requests.post(
'https://api.anticheat.ac/v1/pins/create',
headers={
'x-api-key': 'your_api_key_here',
'Content-Type': 'application/json',
},
json={
'type': 'Java',
'pinName': 'Match #42',
'private': True,
}
)
data = response.json()
print(f"Pin created: {data['pin']}")
print(f"Expires at: {data['expiresAt']}")Fluxo completo: criar + consultar + resultados (JavaScript)
const API_KEY = 'your_api_key_here';
const headers = {
'x-api-key': API_KEY,
'Content-Type': 'application/json',
};
async function createAndTrackPin(gameType, pinName, isPrivate = false) {
const createRes = await fetch('https://api.anticheat.ac/v1/pins/create', {
method: 'POST',
headers,
body: JSON.stringify({
type: gameType,
pinName,
private: isPrivate,
}),
});
const pin = await createRes.json();
console.log('Pin created:', pin.pin, '- Share this code with the player');
while (true) {
const statusRes = await fetch(
'https://api.anticheat.ac/v1/pins/' + pin.pin + '/status',
{ headers }
);
const status = await statusRes.json();
console.log('[' + status.progress + '%] ' + (status.statusMessage || 'Waiting...'));
if (status.isFinished) {
const resultsRes = await fetch(
'https://api.anticheat.ac/v1/pins/' + pin.pin + '/results',
{ headers }
);
return await resultsRes.json();
}
if (status.status === 'expired' || status.status === 'error') {
throw new Error('Scan ' + status.status);
}
await new Promise(r => setTimeout(r, 5000));
}
}
const results = await createAndTrackPin('Java', 'Tournament Finals', true);
console.log('Verdict:', results.result);
console.log('Detections:', results.data.detections);