Справочник 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 | Точный фильтр по идентификатору устройства. |
| status | unused, 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_expire | Unix-время (до 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 — лимит частоты. Полная таблица в обзоре.