LuawardDocs

Массовые операции и экспорт

Создавайте или импортируйте до тысячи ключей, обрабатывайте до пятисот за раз и экспортируйте в JSON или CSV.

POST пакетных ключей принимает JSON до 512 KiB. POST/PUT исходников принимает 4 MiB; стандартный лимит остальных запросов — 16 KiB. Запись требует keys:write; экспорт — действующий ключ с доступом к проекту.

Создание множества ключей

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

Отправьте count (от 1 до 1000), чтобы создать столько ключей, или users (от 1 до 1000), чтобы импортировать уже имеющиеся, например при переходе с Luarmor. Одно из двух, не оба.

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

Для count поля note, key_days и auth_expire — как для одного ключа (бессрочный, если конец не задан). Для users каждая запись содержит user_key (32 буквы) и при желании note, discord_id, identifier, key_days или auth_expire. В ответе created и для count — user_keys, для users — список skipped ключей, которые уже существовали (код KEY_EXISTS). Лимит ключей плана проверяется под блокировкой: вызов, который не помещается, ничего не создаёт (403 PLAN_LIMIT), а одновременные вызовы не могут вместе превысить лимит.

Действия над множеством ключей

RouteЧто делает
POST /v3/projects/:id/users/bulk/banБанит ключи (reason, until как для одного ключа). В ответе объект unban_tokens, по токену на ключ.
POST /v3/projects/:id/users/bulk/unbanСнимает баны.
POST /v3/projects/:id/users/bulk/resethwidОсвобождает ключи от устройств (подойдёт и reset-hwid). Пропускает cooldown проекта, как сброс владельцем.
POST /v3/projects/:id/users/bulk/deleteУдаляет ключи. Каждый попадает в журнал аудита.
POST /v3/projects/:id/users/bulk/extendДобавляет days (от 1 до 36500). Истёкший ключ получает дни от сегодняшнего дня; действующий — к своему концу; неиспользованный ключ «дни с первого использования» получает дополнительные дни; бессрочный не меняется и указывается в unchanged.
{ "user_keys": ["AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "ZyXwVuTsRqPoNmLkJiHgFeDcBaZyXwVu"], "days": 30 }

user_keys содержит от 1 до 500 ключей (повторы считаются один раз). В ответе updated и not_found — ключи, которых нет в этом проекте (ключи другого проекта или воркспейса выглядят так же). Каждое изменение записывается в историю ключей с именем API-ключа.

Экспорт ключей

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

ПараметрЗначение
formatjson (по умолчанию) или csv.
statusunused, active, reset или banned.
limitКлючей за вызов, от 1 до 50000; по умолчанию 10000.
cursornext_cursor предыдущего вызова.

Ключи идут от старых к новым, страницы стыкуются без повторов и пропусков, даже для ключей, созданных в один момент. JSON отвечает users, count и next_cursor (null на последней странице). В CSV есть строка заголовка и те же столбцы, что у ключа в списке; курсор — в заголовке X-Next-Cursor. Ячейка, начинающаяся с =, +, - или @, записывается с кавычкой впереди, чтобы таблица показывала её как текст, а не как формулу.