LuawardDocs

Справочник API v3

Текущие endpoint'ы для метаданных воркспейса, проектов, статистики и управления лицензионными ключами.

Для защищённых маршрутов нужен ключ API workspace. Доступ ограничен scopes, выбранными проектами и разрешёнными IP. Замените PROJECT_ID на доступный проект из Dashboard или GET /v3/projects. Лицензионный ключ содержит 32 ASCII-буквы (A–Z, a–z).

Authorization: Bearer YOUR_DEVELOPER_API_KEY
Content-Type: application/json

Тела — JSON: обычно 16 KiB, исходники скриптов 4 MiB, POST пакетных ключей 512 KiB. Неверные поля возвращают 400 INVALID_FIELD с details. См. обзор.

Публичный статус

GET /v3/status

Аутентификация не нужна.

curl "https://api.luaward.com/v3/status"

Ответ содержит success, status, time (секунды Unix) и version API.

Метаданные воркспейса

GET /v3/keys/:key/details

Требует аутентификации. Возвращает plan воркспейса, rate_limit ключа и projects: все существующие проекты с project_id, project_name, reset_hwid_allowed, reset_hwid_cooldown_days (сколько дней игрок ждёт между сбросами своего устройства; сбросы через API это игнорируют), auto_delete_expired, allow_cloned_hwid, total_users, created_at и их scripts (script_id, script_name, enabled, ffa). Сегмент :key — заглушка, которая никогда не читается. Напишите любое слово, например me, и никогда не вставляйте туда API-ключ: адреса попадают в логи.

GET /v3/keys/:key/stats

Требует аутентификации. Возвращает итоги по всему воркспейсу: total_projects, total_users, active_users и total_executions. Это не отчёт по одному лицензионному ключу. Также возвращает limits: для проектов, скриптов и ключей, сколько используется (used) и сколько разрешает план (max). Добавьте ?noUsers=true, чтобы убрать счётчики пользователей и число ключей (быстрее в воркспейсе с очень большим числом ключей).

Проекты

Проект объединяет скрипты и лицензионные ключи, которые их открывают. Создание, переименование и удаление проектов подчиняются тем же правилам, что и в дашборде, включая лимит проектов вашего плана.

GET /v3/projects

Возвращает projects: те же объекты, что в ответе details, от старых к новым.

GET /v3/projects/:id

Возвращает один project. Проект, которого нет в вашем воркспейсе, удалённый или несуществующий, отвечает 404 с кодом PROJECT_NOT_FOUND.

POST /v3/projects

{
  "name": "My new project",
  "reset_hwid_allowed": true,
  "reset_hwid_cooldown_days": 7
}
ПолеПравило
nameОбязательно. От 1 до 60 символов.
reset_hwid_allowedНеобязательно. Могут ли игроки сбрасывать своё устройство.
reset_hwid_cooldown_daysНеобязательно. От 0 до 365.
auto_delete_expiredНеобязательно. Автоматически удалять истёкшие ключи.
allow_cloned_hwidНеобязательно. Разрешить одному ключу работать на нескольких машинах с общим id устройства.

При успехе возвращается 201 и новый project. Webhook'и и список «принимать также ключи от» настраиваются в дашборде. Отказ: 403 PLAN_LIMIT, когда воркспейс упёрся в лимит проектов.

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

Любое из полей выше; нужно хотя бы одно. Пропущенные поля сохраняют значение. Возвращает обновлённый project.

DELETE /v3/projects/:id

{ "confirm_name": "My new project" }

Для удаления нужно точное название проекта в confirm_name, чтобы неверный id не удалил не тот проект (иначе 400 CONFIRM_REQUIRED). Как в дашборде, проект и его скрипты перестают работать сразу и пропадают из списков. При успехе возвращается Project deleted successfully.

Список лицензионных ключей

GET /v3/projects/:id/users

Необязательные query-параметры:

ПараметрЗначение
pageНомер страницы от 1 до 100000; по умолчанию 1.
limitРезультатов на странице от 1 до 100; по умолчанию 50.
fromНачало окна пользователей, считая от самого нового (0 или больше). Если указан, используется вместо page и limit.
untilКонец этого окна: больше from, но не более чем на 100. По умолчанию from + 50.
searchДо 80 символов, ищется по ключу, заметке, Discord id и identifier. % и _ считаются обычными символами.
user_keyТочный фильтр по лицензионному ключу (32 буквы).
discord_idТочный фильтр по Discord id (от 15 до 22 цифр).
identifierТочный фильтр по идентификатору устройства.
statusunused, active, reset или banned.

Значение, нарушающее правило, возвращает 400; пустые параметры игнорируются. Ответ содержит users, total, page и limit. У каждого пользователя есть user_key, identifier, identifier_type, discord_id, note, auth_expire, key_days, status, banned, ban_reason, total_resets, total_executions, created_at и last_executed_at. При использовании окна ответ содержит from и until вместо page и limit.

Создание лицензионного ключа

POST /v3/projects/:id/users

{
  "note": "Customer order 492",
  "discord_id": "123456789012345678",
  "key_days": 30
}
ПолеПравило
user_keyНеобязательно. Ровно 32 буквы; если не указать, Luaward создаст ключ сам.
noteДо 200 символов.
discord_idОт 15 до 22 цифр.
identifierОт 8 до 200 символов; заранее привязывает ключ к устройству.
key_daysОт 1 до 36500. Ключ действует столько дней с первого использования.
auth_expireUnix-время (до 2100 года), когда ключ заканчивается, или -1, если срока нет. Если указано, key_days игнорируется.

Без key_days и auth_expire ключ не истекает. Ответ возвращает user_key, key_days, auth_expire и created_at. Лицензионные ключи также читаются через аутентифицированные endpoints users; они показываются не один раз. Ключи API разработчика — другие учётные данные, показываемые только при создании.

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}'

Отказы: 403 PLAN_LIMIT, когда воркспейс достиг лимита ключей, 409 KEY_EXISTS, когда такой ключ уже есть.

Изменение ключа

PATCH /v3/projects/:id/users

В теле обязателен user_key и хотя бы одно из note (текст или null, чтобы очистить), discord_id (цифры или null, чтобы очистить) и auth_expire (как выше; заменяет key_days). identifier тоже принимается: от 8 до 200 символов, чтобы привязать ключ к устройству, или null, чтобы снять привязку.

{
  "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf",
  "note": "Renewed",
  "auth_expire": -1
}

Удаление ключа

DELETE /v3/projects/:id/users

Передайте user_key в JSON-теле или query-параметром, как делает Luarmor (тело не пускает ключ в адрес). Успех возвращает User deleted successfully. Удаление записывается в журнал аудита воркспейса.

Сброс привязки к устройству

POST /v3/projects/:id/users/reset-hwid

{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf" }

Успех возвращает HWID reset successfully. Следующий корректный запуск снова может привязать ключ к устройству. Как сброс владельца в дашборде, он игнорирует cooldown проекта. Написание Luarmor POST /v3/projects/:id/users/resethwid тоже работает. force принимается и ничего не меняет, потому что сброс здесь всегда пропускает cooldown.

Привязка аккаунта Discord

POST /v3/projects/:id/users/linkdiscord

{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "discord_id": "123456789012345678" }

discord_id состоит из 15–22 цифр. Ключ, уже привязанный к другому аккаунту, не меняется и отвечает 409 ALREADY_LINKED, если не отправить "force": true. Повторная привязка того же аккаунта проходит. Это то же, что discord_id в PATCH, но с такой защитой.

Бан и разбан ключа

POST /v3/projects/:id/users/ban

{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "reason": "Refunded order", "until": 1893456000 }

reason — до 200 символов. until — Unix-время окончания бана; без него бан постоянный. Новый бан заменяет дату окончания прежнего. Ответ содержит unban_token (32 буквы), который принимает ссылка разбана в loader. Чтобы разбанить через API, вызовите POST /v3/projects/:id/users/unban с телом, где есть user_key; он очищает причину, дату окончания и токен. Маршрут Luarmor POST /v3/projects/:id/users/blacklist и поля ban_reason и ban_expire (-1 означает навсегда) тоже работают; если отправлены оба написания, действуют наши. Тот, у кого есть токен, может снять бан и без API-ключа через GET /v3/projects/:id/users/unban?unban_token=TOKEN: работает один раз, только внутри этого проекта, не более 10 попыток в минуту с одного адреса.

Типичные ответы с ошибкой

Ошибки содержат success: false, фразу в error и code. 400 — тело или поле нарушает правило, 401 — ключа нет, он неверный или отозван, 403 — адрес не в списке, аккаунт приостановлен или лимит ключей или проектов плана, 404 — нет проекта или ключа, 409 — дубликат ключа, 413 — тело больше 16 КБ, 429 — лимит частоты. Полная таблица в обзоре.