LuawardDocs

Claves en masa y exportación

Crea o importa hasta mil claves, actúa sobre hasta quinientas a la vez y exporta como JSON o CSV.

POST de claves en lote admite JSON de hasta 512 KiB. POST/PUT de código admite 4 MiB; las demás solicitudes tienen un límite predeterminado de 16 KiB. Escribir exige keys:write; exportar exige una clave activa con acceso al proyecto.

Crear muchas claves

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

Envía count (1 a 1000) para crear esa cantidad de claves, o users (1 a 1000) para traer claves que ya tienes, como al migrar desde Luarmor. Una u otra, no ambas.

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

Con count, note, key_days y auth_expire valen como para una clave (de por vida si no se da ningún final). Con users, cada elemento trae user_key (32 letras) y, si quieres, note, discord_id, identifier, key_days o auth_expire. La respuesta tiene created y, para count, las user_keys; para users, una lista skipped de las claves que ya existían (código KEY_EXISTS). El límite de claves del plan se comprueba bajo un bloqueo: una llamada que no cabe no crea nada (403 PLAN_LIMIT), y llamadas simultáneas no pueden pasar juntas el límite.

Actuar sobre muchas claves

RouteQué hace
POST /v3/projects/:id/users/bulk/banBanea las claves (reason, until como para una clave). La respuesta trae el objeto unban_tokens, un token por clave.
POST /v3/projects/:id/users/bulk/unbanLevanta los baneos.
POST /v3/projects/:id/users/bulk/resethwidLibera las claves de sus dispositivos (reset-hwid también sirve). Se salta el cooldown del proyecto, como el restablecimiento de un propietario.
POST /v3/projects/:id/users/bulk/deleteElimina las claves. Cada una queda en el registro de auditoría.
POST /v3/projects/:id/users/bulk/extendSuma days (1 a 36500). Una clave que ya terminó recibe los días desde hoy; una aún activa los recibe sumados a su final; una clave de "días desde el primer uso" sin usar gana más días; una de por vida se deja como está y se lista en unchanged.
{ "user_keys": ["AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "ZyXwVuTsRqPoNmLkJiHgFeDcBaZyXwVu"], "days": 30 }

user_keys trae de 1 a 500 claves (las repetidas cuentan una vez). La respuesta tiene updated y not_found, las claves que no están en este proyecto (las de otro proyecto o workspace se ven igual). Cada cambio queda en el historial de las claves con el nombre de la clave de API.

Exportar claves

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

ParámetroSignificado
formatjson (por defecto) o csv.
statusunused, active, reset o banned.
limitClaves por llamada, de 1 a 50000; por defecto 10000.
cursorEl next_cursor de la llamada anterior.

Las claves vienen de la más antigua a la más nueva y las páginas encajan sin repetir ni faltar, incluso para claves creadas en el mismo instante. El JSON responde users, count y next_cursor (null en la última página). El CSV tiene una fila de cabecera y las mismas columnas que una clave en la lista; el cursor va en la cabecera X-Next-Cursor. Una celda que empieza por =, +, - o @ se escribe con una comilla delante para que la hoja de cálculo la muestre como texto, nunca como fórmula.