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/jsonCorpos 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
}| Campo | Regra |
|---|---|
| name | Obrigatório. De 1 a 60 caracteres. |
| reset_hwid_allowed | Opcional. Se os jogadores podem redefinir o próprio dispositivo. |
| reset_hwid_cooldown_days | Opcional. De 0 a 365. |
| auto_delete_expired | Opcional. Exclui automaticamente as chaves expiradas. |
| allow_cloned_hwid | Opcional. 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âmetro | Significado |
|---|---|
| page | Número da página, de 1 a 100000; padrão 1. |
| limit | Resultados por página, de 1 a 100; padrão 50. |
| from | Iní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. |
| until | Fim dessa janela: acima de from, por no máximo 100. Padrão: from + 50. |
| search | Até 80 caracteres, comparados com a chave, a nota, o Discord id e o identifier. % e _ contam como caracteres comuns. |
| user_key | Filtro exato por chave de licença (32 letras). |
| discord_id | Filtro exato por Discord id (15 a 22 dígitos). |
| identifier | Filtro exato por identificador de dispositivo. |
| status | unused, 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
}| Campo | Regra |
|---|---|
| user_key | Opcional. Exatamente 32 letras; o Luaward cria uma quando você omite. |
| note | Até 200 caracteres. |
| discord_id | 15 a 22 dígitos. |
| identifier | 8 a 200 caracteres; liga a chave a um dispositivo com antecedência. |
| key_days | 1 a 36500. A chave dura esse número de dias a partir do primeiro uso. |
| auth_expire | Segundos 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.