Referencia de API v3
Endpoints actuales para metadatos del workspace, proyectos, estadísticas y gestión de claves de licencia.
Las rutas autenticadas requieren una clave de API del workspace. Scopes, restricciones de proyecto e IP permitidas limitan el acceso. Sustituye PROJECT_ID por un proyecto permitido del Dashboard o GET /v3/projects. Las claves de licencia tienen 32 letras ASCII (A–Z, a–z).
Authorization: Bearer YOUR_DEVELOPER_API_KEY
Content-Type: application/jsonLos cuerpos son JSON: predeterminado 16 KiB, código de scripts 4 MiB, POST de claves en lote 512 KiB. Los campos incorrectos devuelven 400 INVALID_FIELD con details. Consulta el resumen.
Estado público
GET /v3/status
No requiere autenticación.
curl "https://api.luaward.com/v3/status"La respuesta contiene success, status, time (segundos Unix) y la version de la API.
Metadatos del workspace
GET /v3/keys/:key/details
Requiere autenticación. Devuelve el plan del workspace, el rate_limit de la clave y projects: todos los proyectos existentes con project_id, project_name, reset_hwid_allowed, reset_hwid_cooldown_days (cuántos días espera un jugador entre restablecimientos de su propio dispositivo; los que haces por la API lo ignoran), auto_delete_expired, allow_cloned_hwid, total_users, created_at y sus scripts (script_id, script_name, enabled, ffa). El segmento :key es un marcador que nunca se lee. Escribe cualquier palabra, como me, y nunca pongas ahí tu clave de API, porque las direcciones quedan en logs.
GET /v3/keys/:key/stats
Requiere autenticación. Devuelve totales de todo el workspace: total_projects, total_users, active_users y total_executions. No es un informe de una sola clave de licencia. También devuelve limits: para proyectos, scripts y claves, cuántos están en uso (used) y lo que permite el plan (max). Añade ?noUsers=true para omitir los recuentos de usuarios y la cifra de claves (más rápido en un workspace con muchísimas claves).
Proyectos
Un proyecto agrupa scripts y las claves de licencia que los abren. Crear, renombrar y eliminar proyectos sigue las mismas reglas del dashboard, incluido el límite de proyectos de tu plan.
GET /v3/projects
Devuelve projects: los mismos objetos de la respuesta de details, del más antiguo al más nuevo.
GET /v3/projects/:id
Devuelve un project. Un proyecto que no está en tu workspace, fue eliminado o no existe responde 404 con el código PROJECT_NOT_FOUND.
POST /v3/projects
{
"name": "My new project",
"reset_hwid_allowed": true,
"reset_hwid_cooldown_days": 7
}| Campo | Regla |
|---|---|
| name | Obligatorio. De 1 a 60 caracteres. |
| reset_hwid_allowed | Opcional. Si los jugadores pueden restablecer su propio dispositivo. |
| reset_hwid_cooldown_days | Opcional. De 0 a 365. |
| auto_delete_expired | Opcional. Elimina automáticamente las claves caducadas. |
| allow_cloned_hwid | Opcional. Deja que una clave funcione en varias máquinas que comparten un id de dispositivo. |
El éxito devuelve 201 y el nuevo project. Los webhooks y la lista "aceptar también claves de" se configuran en el dashboard. Rechazo: 403 PLAN_LIMIT cuando el workspace está en su límite de proyectos.
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
Cualquiera de los campos anteriores; se necesita al menos uno. Los campos que omitas conservan su valor. Devuelve el project actualizado.
DELETE /v3/projects/:id
{ "confirm_name": "My new project" }Eliminar exige el nombre exacto del proyecto en confirm_name, para que un id equivocado no borre el proyecto equivocado (si no, 400 CONFIRM_REQUIRED). Como en el dashboard, el proyecto y sus scripts dejan de funcionar al instante y salen de tus listas. El éxito devuelve Project deleted successfully.
Listar claves de licencia
GET /v3/projects/:id/users
Parámetros de consulta opcionales:
| Parámetro | Significado |
|---|---|
| page | Número de página, de 1 a 100000; por defecto 1. |
| limit | Resultados por página, de 1 a 100; por defecto 50. |
| from | Inicio de una ventana de usuarios, contada desde el más nuevo (0 o más). Si se envía, se usa en lugar de page y limit. |
| until | Final de esa ventana: por encima de from, como máximo 100. Por defecto, from + 50. |
| search | Hasta 80 caracteres, comparados con la clave, la nota, el Discord id y el identifier. % y _ cuentan como caracteres normales. |
| user_key | Filtro exacto por clave de licencia (32 letras). |
| discord_id | Filtro exacto por Discord id (15 a 22 dígitos). |
| identifier | Filtro exacto por identificador de dispositivo. |
| status | unused, active, reset o banned. |
Un valor que incumple una regla devuelve 400; los parámetros vacíos se ignoran. La respuesta contiene users, total, page y limit. Cada usuario tiene user_key, identifier, identifier_type, discord_id, note, auth_expire, key_days, status, banned, ban_reason, total_resets, total_executions, created_at y last_executed_at. Con una ventana, la respuesta trae from y until en lugar de page y limit.
Crear una clave de licencia
POST /v3/projects/:id/users
{
"note": "Customer order 492",
"discord_id": "123456789012345678",
"key_days": 30
}| Campo | Regla |
|---|---|
| user_key | Opcional. Exactamente 32 letras; Luaward crea una si la omites. |
| note | Hasta 200 caracteres. |
| discord_id | De 15 a 22 dígitos. |
| identifier | De 8 a 200 caracteres; vincula la clave a un dispositivo de antemano. |
| key_days | De 1 a 36500. La clave dura ese número de días desde su primer uso. |
| auth_expire | Segundos Unix (hasta el año 2100) en que termina la clave, o -1 para que no termine. Si se indica, key_days se ignora. |
Sin key_days ni auth_expire, la clave no caduca. La respuesta devuelve user_key, key_days, auth_expire y created_at. Las claves de licencia también se leen mediante los endpoints users autenticados; no se muestran solo una vez. Las claves de API de desarrollador son credenciales distintas mostradas solo al crearlas.
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}'Rechazos: 403 PLAN_LIMIT cuando el workspace está en su límite de claves, 409 KEY_EXISTS cuando esa clave ya existe.
Actualizar una clave
PATCH /v3/projects/:id/users
El cuerpo debe incluir user_key y al menos uno de note (texto, o null para borrarla), discord_id (dígitos, o null para borrarlo) y auth_expire (como arriba; sustituye a key_days). También se acepta identifier: de 8 a 200 caracteres para vincular la clave a un dispositivo, o null para quitar el vínculo.
{
"user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf",
"note": "Renewed",
"auth_expire": -1
}Eliminar una clave
DELETE /v3/projects/:id/users
Pasa user_key en un cuerpo JSON o como parámetro de consulta, como hace Luarmor (el cuerpo mantiene la clave fuera de la dirección). El éxito devuelve User deleted successfully. La eliminación queda en el registro de auditoría del workspace.
Restablecer el vínculo con el dispositivo
POST /v3/projects/:id/users/reset-hwid
{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf" }El éxito devuelve HWID reset successfully. La siguiente ejecución válida puede vincular la clave a un dispositivo otra vez. Como el restablecimiento del propietario en el dashboard, ignora el cooldown del proyecto. La grafía de Luarmor POST /v3/projects/:id/users/resethwid también funciona. force se acepta y no cambia nada, porque un restablecimiento aquí siempre se salta el cooldown.
Vincular una cuenta de Discord
POST /v3/projects/:id/users/linkdiscord
{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "discord_id": "123456789012345678" }discord_id tiene de 15 a 22 dígitos. Una clave ya vinculada a otra cuenta no se toca y responde 409 ALREADY_LINKED, salvo que envíes "force": true. Vincular la misma cuenta otra vez funciona. Hace lo mismo que discord_id en PATCH, con esa protección.
Bloquear y desbloquear una clave
POST /v3/projects/:id/users/ban
{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "reason": "Refunded order", "until": 1893456000 }reason admite hasta 200 caracteres. until es la hora Unix en que termina el bloqueo; omítelo para un bloqueo permanente. Un bloqueo nuevo sustituye la fecha final de uno anterior. La respuesta contiene un unban_token (32 letras) que acepta el enlace de desbloqueo del loader. Para desbloquear por la API, llama a POST /v3/projects/:id/users/unban con un cuerpo que contenga user_key; borra el motivo, la fecha final y el token. La ruta de Luarmor POST /v3/projects/:id/users/blacklist y sus nombres ban_reason y ban_expire (-1 significa permanente) también funcionan; si se envían ambas grafías, valen las nuestras. Quien tenga el token también puede levantar el baneo sin clave de API, con GET /v3/projects/:id/users/unban?unban_token=TOKEN: funciona una vez, solo dentro de ese proyecto, y se limita a 10 intentos por minuto por dirección.
Respuestas de error habituales
Los errores traen success: false, una frase en error y un code. 400 es un cuerpo o campo que rompe una regla, 401 una clave ausente, incorrecta o revocada, 403 una dirección fuera de la lista, una cuenta suspendida o el límite de claves o de proyectos del plan, 404 un proyecto o clave inexistente, 409 una clave duplicada, 413 un cuerpo de más de 16 KB y 429 un límite de tasa. El resumen tiene la tabla completa.