LuawardDocs

Chaves em massa e exportação

Crie ou importe até mil chaves, aja em até quinhentas de uma vez e exporte como JSON ou CSV.

POST de chaves em lote aceita JSON de até 512 KiB. POST/PUT de código aceita 4 MiB; outras requisições têm limite padrão de 16 KiB. Escrita exige keys:write; exportação exige chave ativa com acesso ao projeto.

Criar muitas chaves

POST /v3/projects/:id/users/bulk

Envie count (1 a 1000) para criar essa quantidade de chaves, ou users (1 a 1000) para trazer chaves que você já tem, como ao migrar do Luarmor. Um ou outro, não os dois.

{ "count": 200, "note": "Giveaway", "key_days": 30 }
{
  "users": [
    { "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "note": "from Luarmor", "discord_id": "123456789012345678", "auth_expire": 1893456000 }
  ]
}

Com count, note, key_days e auth_expire valem como para uma chave (vitalícia quando nenhum fim é dado). Com users, cada item traz user_key (32 letras) e, se quiser, note, discord_id, identifier, key_days ou auth_expire. A resposta tem created e, para count, as user_keys; para users, uma lista skipped das chaves que já existiam (código KEY_EXISTS). O limite de chaves do plano é checado sob um bloqueio: uma chamada que não cabe não cria nada (403 PLAN_LIMIT), e chamadas simultâneas não passam juntas do limite.

Agir em muitas chaves

RouteO que faz
POST /v3/projects/:id/users/bulk/banBane as chaves (reason, until como para uma chave). A resposta traz o objeto unban_tokens, um token por chave.
POST /v3/projects/:id/users/bulk/unbanRetira os banimentos.
POST /v3/projects/:id/users/bulk/resethwidLibera as chaves de seus dispositivos (reset-hwid também serve). Ignora o cooldown do projeto, como a redefinição de um dono.
POST /v3/projects/:id/users/bulk/deleteExclui as chaves. Cada uma vai para o log de auditoria.
POST /v3/projects/:id/users/bulk/extendSoma days (1 a 36500). Uma chave que já terminou recebe os dias a partir de hoje; uma ainda ativa os recebe somados ao fim; uma chave "dias desde o primeiro uso" não usada ganha mais dias; uma vitalícia é deixada como está e listada em unchanged.
{ "user_keys": ["AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "ZyXwVuTsRqPoNmLkJiHgFeDcBaZyXwVu"], "days": 30 }

user_keys traz de 1 a 500 chaves (repetidas contam uma vez). A resposta tem updated e not_found, as chaves que não estão neste projeto (chaves de outro projeto ou workspace parecem iguais). Cada mudança vai para o histórico das chaves com o nome da chave de API.

Exportar chaves

GET /v3/projects/:id/users/export

ParâmetroSignificado
formatjson (padrão) ou csv.
statusunused, active, reset ou banned.
limitChaves por chamada, de 1 a 50000; padrão 10000.
cursorO next_cursor da chamada anterior.

As chaves vêm do mais antigo ao mais novo e as páginas se encaixam sem repetir nem faltar, mesmo para chaves criadas no mesmo instante. O JSON responde users, count e next_cursor (null na última página). O CSV tem uma linha de cabeçalho e as mesmas colunas de uma chave na lista; o cursor vem no cabeçalho X-Next-Cursor. Uma célula que começa com =, +, - ou @ é escrita com uma aspa na frente para a planilha mostrá-la como texto, nunca como fórmula.