LuawardDocs

Referência da API v3

Endpoints atuais para metadados do workspace, projetos, estatísticas e gerenciamento de chaves de licença.

Rotas autenticadas exigem chave de API do workspace. Scopes, restrições de projeto e whitelist de IP limitam o acesso. Substitua PROJECT_ID por um projeto permitido do Dashboard ou GET /v3/projects. Chaves de licença contêm 32 letras ASCII (A–Z, a–z).

Authorization: Bearer YOUR_DEVELOPER_API_KEY
Content-Type: application/json

Corpos são JSON: padrão 16 KiB, código de script 4 MiB, POST de chaves em lote 512 KiB. Campos inválidos retornam 400 INVALID_FIELD com details. Veja a visão geral.

Status público

GET /v3/status

Não exige autenticação.

curl "https://api.luaward.com/v3/status"

A resposta contém success, status, time (segundos Unix) e a version da API.

Metadados do workspace

GET /v3/keys/:key/details

Exige autenticação. Retorna o plan do workspace, o rate_limit da chave e projects: todos os projetos existentes com project_id, project_name, reset_hwid_allowed, reset_hwid_cooldown_days (quantos dias um jogador espera entre redefinições do próprio dispositivo; as redefinições feitas pela API ignoram isso), auto_delete_expired, allow_cloned_hwid, total_users, created_at e seus scripts (script_id, script_name, enabled, ffa). O segmento :key é um marcador que nunca é lido. Escreva qualquer palavra, como me, e nunca coloque sua chave de API ali, porque os endereços ficam em logs.

GET /v3/keys/:key/stats

Exige autenticação. Retorna totais de todo o workspace: total_projects, total_users, active_users e total_executions. Não é um relatório de uma só chave de licença. Também retorna limits: para projetos, scripts e chaves, quantos estão em uso (used) e o que o plano permite (max). Adicione ?noUsers=true para omitir as contagens de usuários e o número de chaves (mais rápido em um workspace com muitíssimas chaves).

Projetos

Um projeto reúne scripts e as chaves de licença que os abrem. Criar, renomear e excluir projetos segue as mesmas regras do dashboard, inclusive o limite de projetos do seu plano.

GET /v3/projects

Retorna projects: os mesmos objetos da resposta de details, do mais antigo ao mais novo.

GET /v3/projects/:id

Retorna um project. Um projeto que não está no seu workspace, foi excluído ou não existe responde 404 com o código PROJECT_NOT_FOUND.

POST /v3/projects

{
  "name": "My new project",
  "reset_hwid_allowed": true,
  "reset_hwid_cooldown_days": 7
}
CampoRegra
nameObrigatório. De 1 a 60 caracteres.
reset_hwid_allowedOpcional. Se os jogadores podem redefinir o próprio dispositivo.
reset_hwid_cooldown_daysOpcional. De 0 a 365.
auto_delete_expiredOpcional. Exclui automaticamente as chaves expiradas.
allow_cloned_hwidOpcional. Permite que uma chave rode em várias máquinas que compartilham um id de dispositivo.

O sucesso retorna 201 e o novo project. Webhooks e a lista "aceitar também chaves de" são definidos no dashboard. Recusa: 403 PLAN_LIMIT quando o workspace está no limite de projetos.

curl -X POST "https://api.luaward.com/v3/projects" \
  -H "Authorization: Bearer YOUR_DEVELOPER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My new project"}'

PATCH /v3/projects/:id

Qualquer um dos campos acima; pelo menos um é obrigatório. Campos omitidos mantêm o valor. Retorna o project atualizado.

DELETE /v3/projects/:id

{ "confirm_name": "My new project" }

Excluir exige o nome exato do projeto em confirm_name, para que um id errado não remova o projeto errado (senão 400 CONFIRM_REQUIRED). Como no dashboard, o projeto e seus scripts param de funcionar na hora e saem das listas. O sucesso retorna Project deleted successfully.

Listar chaves de licença

GET /v3/projects/:id/users

Parâmetros de consulta opcionais:

ParâmetroSignificado
pageNúmero da página, de 1 a 100000; padrão 1.
limitResultados por página, de 1 a 100; padrão 50.
fromInício de uma janela de usuários, contada a partir do mais novo (0 ou mais). Quando enviado, vale no lugar de page e limit.
untilFim dessa janela: acima de from, por no máximo 100. Padrão: from + 50.
searchAté 80 caracteres, comparados com a chave, a nota, o Discord id e o identifier. % e _ contam como caracteres comuns.
user_keyFiltro exato por chave de licença (32 letras).
discord_idFiltro exato por Discord id (15 a 22 dígitos).
identifierFiltro exato por identificador de dispositivo.
statusunused, active, reset ou banned.

Um valor que quebra uma regra retorna 400; parâmetros vazios são ignorados. A resposta contém users, total, page e limit. Cada usuário tem user_key, identifier, identifier_type, discord_id, note, auth_expire, key_days, status, banned, ban_reason, total_resets, total_executions, created_at e last_executed_at. Com uma janela, a resposta traz from e until no lugar de page e limit.

Criar uma chave de licença

POST /v3/projects/:id/users

{
  "note": "Customer order 492",
  "discord_id": "123456789012345678",
  "key_days": 30
}
CampoRegra
user_keyOpcional. Exatamente 32 letras; o Luaward cria uma quando você omite.
noteAté 200 caracteres.
discord_id15 a 22 dígitos.
identifier8 a 200 caracteres; liga a chave a um dispositivo com antecedência.
key_days1 a 36500. A chave dura esse número de dias a partir do primeiro uso.
auth_expireSegundos Unix (até o ano 2100) em que a chave termina, ou -1 para nunca terminar. Quando informado, key_days é ignorado.

Sem key_days nem auth_expire, a chave não expira. A resposta retorna user_key, key_days, auth_expire e created_at. Chaves de licença também podem ser lidas nos endpoints users autenticados; não são mostradas apenas uma vez. Chaves de API de desenvolvedor são credenciais diferentes, exibidas somente na criação.

curl -X POST "https://api.luaward.com/v3/projects/PROJECT_ID/users" \
  -H "Authorization: Bearer YOUR_DEVELOPER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"note":"Customer order 492","key_days":30}'

Recusas: 403 PLAN_LIMIT quando o workspace está no limite de chaves, 409 KEY_EXISTS quando essa chave já existe.

Atualizar uma chave

PATCH /v3/projects/:id/users

O corpo deve incluir user_key e ao menos um entre note (texto, ou null para limpar), discord_id (dígitos, ou null para limpar) e auth_expire (como acima; substitui key_days). identifier também é aceito: de 8 a 200 caracteres para vincular a chave a um dispositivo, ou null para remover o vínculo.

{
  "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf",
  "note": "Renewed",
  "auth_expire": -1
}

Excluir uma chave

DELETE /v3/projects/:id/users

Envie user_key em um corpo JSON ou como parâmetro de consulta, como o Luarmor faz (o corpo mantém a chave fora do endereço). O sucesso retorna User deleted successfully. A exclusão fica registrada no log de auditoria do workspace.

Redefinir o vínculo com o dispositivo

POST /v3/projects/:id/users/reset-hwid

{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf" }

O sucesso retorna HWID reset successfully. A próxima execução válida pode vincular a chave a um dispositivo de novo. Como a redefinição do dono no dashboard, ela ignora o cooldown do projeto. A grafia do Luarmor POST /v3/projects/:id/users/resethwid também funciona. force é aceito e não muda nada, porque uma redefinição aqui sempre ignora o cooldown.

Vincular uma conta do Discord

POST /v3/projects/:id/users/linkdiscord

{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "discord_id": "123456789012345678" }

discord_id tem de 15 a 22 dígitos. Uma chave já vinculada a outra conta não é alterada e responde 409 ALREADY_LINKED, a menos que você envie "force": true. Vincular a mesma conta de novo dá certo. Faz o mesmo que discord_id no PATCH, com essa proteção.

Banir e desbanir uma chave

POST /v3/projects/:id/users/ban

{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "reason": "Refunded order", "until": 1893456000 }

reason tem até 200 caracteres. until é o horário Unix em que o banimento termina; omita para um banimento permanente. Um novo banimento substitui a data final de um anterior. A resposta contém um unban_token (32 letras) que o link de desbanimento do loader aceita. Para desbanir pela API, chame POST /v3/projects/:id/users/unban com um corpo contendo user_key; ele limpa o motivo, a data final e o token. A rota do Luarmor POST /v3/projects/:id/users/blacklist e os nomes ban_reason e ban_expire (-1 significa permanente) também funcionam; se as duas grafias forem enviadas, valem as nossas. Quem tem o token também pode retirar o banimento sem chave de API, com GET /v3/projects/:id/users/unban?unban_token=TOKEN: funciona uma vez, só dentro daquele projeto, e é limitado a 10 tentativas por minuto por endereço.

Respostas de erro comuns

Os erros trazem success: false, uma frase em error e um code. 400 é um corpo ou campo que quebra uma regra, 401 uma chave ausente, errada ou revogada, 403 um endereço fora da lista, uma conta suspensa ou o limite de chaves ou de projetos do plano, 404 um projeto ou chave que não existe, 409 uma chave duplicada, 413 um corpo acima de 16 KB e 429 um limite de taxa. A visão geral tem a tabela completa.