Журнал аудита

Журнал аудита — автоматическая запись всех административных действий, происходящих в гильдии: изменение настроек, создание и удаление ролей, каналы, бан-листы, веб-хуки.

Читать журнал может любой участник с правом VIEW_AUDIT_LOG.

Получение записей

GET /api/v1/guilds/:guild_id/audit-logs
Authorization: Bot ВАШ_БОТ_ТОКЕН

Query-параметры:

Параметр	Тип	По умолчанию	Описание
`user_id`	snowflake	—	Показать только действия этого пользователя
`action_type`	integer	—	Фильтр по типу (см. таблицу ниже)
`before`	snowflake	—	Вернуть записи, созданные до этого ID (пагинация назад)
`after`	snowflake	—	После этого ID (пагинация вперёд)
`limit`	integer	50	От 1 до 100

Структура ответа

{
  "audit_log_entries": [
    {
      "id": "1465...",
      "target_id": "1462...",
      "user_id": "974...",
      "action_type": 20,
      "reason": "Спам в #general",
      "changes": [],
      "options": null,
      "created_at": "2026-04-23T12:34:56.000Z"
    }
  ],
  "users": [ { "id": "974...", "username": "moderator", ... } ],
  "webhooks": [],
  "threads": []
}

target_id — объект действия (user, channel, role, и т.д.). Что именно — определяется action_type
user_id — кто совершил действие
reason — причина, переданная через заголовок X-Audit-Log-Reason при вызывающем API-запросе
changes — массив {key, old_value, new_value} для типов, изменяющих поля (например, GUILD_UPDATE)
options — дополнительный контекст (например, для MEMBER_MOVE — ID канала, куда переместили)

Типы действий

Код	Название	Что логируется
`1`	`GUILD_UPDATE`	Изменение настроек гильдии
`10`	`CHANNEL_CREATE`	Создан канал
`11`	`CHANNEL_UPDATE`	Канал изменён
`12`	`CHANNEL_DELETE`	Канал удалён
`13`	`CHANNEL_OVERWRITE_CREATE`	Создан permission overwrite
`14`	`CHANNEL_OVERWRITE_UPDATE`	Overwrite изменён
`15`	`CHANNEL_OVERWRITE_DELETE`	Overwrite удалён
`20`	`MEMBER_KICK`	Участник кикнут
`21`	`MEMBER_PRUNE`	Массовая чистка неактивных
`22`	`MEMBER_BAN_ADD`	Участник забанен
`23`	`MEMBER_BAN_REMOVE`	Бан снят
`24`	`MEMBER_UPDATE`	Изменены данные участника (ник, timeout)
`25`	`MEMBER_ROLE_UPDATE`	Изменены роли участника
`26`	`MEMBER_MOVE`	Участник перемещён между голосовыми каналами
`27`	`MEMBER_DISCONNECT`	Участник отключён от голоса модератором
`28`	`BOT_ADD`	Бот добавлен в гильдию
`30`	`ROLE_CREATE`	Создана роль
`31`	`ROLE_UPDATE`	Роль изменена
`32`	`ROLE_DELETE`	Роль удалена
`40`	`INVITE_CREATE`	Создано приглашение
`41`	`INVITE_UPDATE`	Приглашение изменено
`42`	`INVITE_DELETE`	Приглашение удалено
`50`	`WEBHOOK_CREATE`	Создан вебхук
`51`	`WEBHOOK_UPDATE`	Вебхук изменён
`52`	`WEBHOOK_DELETE`	Вебхук удалён
`60`	`EMOJI_CREATE`	Добавлен эмоджи
`61`	`EMOJI_UPDATE`	Эмоджи переименован
`62`	`EMOJI_DELETE`	Эмоджи удалён
`72`	`MESSAGE_DELETE`	Удалено чужое сообщение (не автор)
`73`	`MESSAGE_BULK_DELETE`	Массовое удаление сообщений
`74`	`MESSAGE_PIN`	Сообщение закреплено
`75`	`MESSAGE_UNPIN`	Сообщение откреплено
`90`	`STICKER_CREATE`	Добавлен стикер
`91`	`STICKER_UPDATE`	Стикер изменён
`92`	`STICKER_DELETE`	Стикер удалён

Добавление `reason` к своим действиям

Любой запрос, который создаёт запись в журнале, принимает заголовок X-Audit-Log-Reason. Его содержимое попадёт в поле reason лога:

curl -X DELETE https://floodilka.com/api/v1/channels/$CHANNEL_ID/messages/$MSG_ID \
  -H "Authorization: Bot $TOKEN" \
  -H "X-Audit-Log-Reason: Нарушение правил: ссылка на фишинг"

Максимальная длина — 512 символов. Пишите человеко-читаемые причины: модераторам потом разбираться.

Что дальше

Права доступа — VIEW_AUDIT_LOG и другие биты
Коды ошибок — AUDIT_LOG_INDEXING при попытке читать лог во время переиндексации