Documentação da API

Compile scripts e resources a partir do seu servidor, site ou ferramenta. A API recebe o arquivo e devolve o resultado compilado.

Use sua chave de acesso nas requisições. Os exemplos abaixo mostram os formatos de envio e retorno.

Autenticação e Segurança

Todas as chamadas à API são autenticadas por meio de uma API Key única. Você pode enviar a chave através de qualquer um destes formatos:

Endpoint: Compilar Script

Parâmetro opcional profile: light, balanced (padrão) ou extra. O campo mode do resultado informa as etapas efetivamente aplicadas. O ZIP inclui __doiska_build_report.json.

Recebe o código Lua puro em formato texto e devolve o binário compilado e blindado.

Parâmetros da Requisição (JSON Body)

Endpoint: Compilar Resource Completo (.ZIP / .RAR)

Envie um ZIP ou RAR com o resource. Scripts e modelos selecionados são compilados; arquivos excluídos são preservados. O meta.xml é atualizado para os nomes dos modelos gerados.

Parâmetros da Requisição (Multipart ou JSON)

{
  "success": true,
  "filename": "meu_resource_compilado.zip",
  "size": 348210,
  "total_files": 12,
  "compiled_count": 5,
  "skipped_count": 1,
  "other_count": 6,
  "compiled_files": ["client/gui.lua", "client/main.lua", "server/core.lua", "server/database.lua", "server/events.lua"],
  "skipped_files": ["config.lua"],
  "execution_time_ms": 280,
  "zip_base64": "UEsDBBQAAAAIA..."
}

Mapas: use Importar pacote para enviar um ZIP com .map/.maps. Os mapas selecionados são convertidos para scripts de servidor; o meta.xml é criado ou ajustado automaticamente. Pela API, envie compile_maps=true.

Endpoint: Consultar Cota & Status

Consulta a validade da chave informada, status operacional, cota consumida hoje, saldo restante e limites configurados.

{
  "valid": true,
  "name": "Cliente VIP 01",
  "status": "active",
  "allowed_modes": "*",
  "allowed_domains": "*",
  "requests_today": 14,
  "max_daily_requests": 200,
  "remaining_today": 186,
  "total_requests": 1420,
  "expires_at": "Permanente",
  "last_used_at": "03/10/2026 13:42:10"
}

Blindagem do Script & Modos de Operação

Compile um script individual ou processe um resource completo.

Guias de Integração Prática

Selecione a sua linguagem ou ambiente para visualizar o código pronto para produção:

API Playground Interativo

Teste uma requisição com sua chave ou consulte a cota disponível.

// Clique em 'Executar Compilação via API' para disparar o teste ao vivo.

Formatos de Retorno

Se output for base64 (padrão), a resposta será um objeto JSON:

{
  "success": true,
  "filename": "client.luac",
  "compiled": "G0x1YTRNAQI...",
  "size": 16230,
  "mode": "mtax_shield_vm",
  "execution_time_ms": 142,
  "quota": {
    "key_name": "Site Parceiro",
    "requests_today": 12,
    "max_daily_requests": 500,
    "total_requests": 1480
  }
}

Se output for binary ou a URL contiver ?download=1, o servidor responde com cabeçalho Content-Type: application/octet-stream e Content-Disposition: attachment; filename="client.luac", permitindo que o navegador faça o download instantaneamente.

Códigos de Resposta HTTP