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
| Route | Qué hace |
|---|---|
| POST /v3/projects/:id/users/bulk/ban | Banea 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/unban | Levanta los baneos. |
| POST /v3/projects/:id/users/bulk/resethwid | Libera 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/delete | Elimina las claves. Cada una queda en el registro de auditoría. |
| POST /v3/projects/:id/users/bulk/extend | Suma 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ámetro | Significado |
|---|---|
| format | json (por defecto) o csv. |
| status | unused, active, reset o banned. |
| limit | Claves por llamada, de 1 a 50000; por defecto 10000. |
| cursor | El 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.