Kodari Messenger

Документация Kodari Messenger Администрирование чата getChatAdminLog
🌙

getChatAdminLog

getChatAdminLog

Журнал действий администраторов чата. Доступен боту с ролью admin или owner.

GET https://api.kodari.ru/msg/bot.php?method=getChatAdminLog&chat_id=123&limit=50&offset=0
Authorization: Bearer bot_ВАШ_ТОКЕН

Параметры

ПараметрТипПо умолчаниюОписание
chat_idint—ID чата, обязателен
limitint50Записей за раз, максимум 100
offsetint0Смещение для постраничного вывода

Ответ

Массив записей, новые первыми.

{
  "ok": true,
  "result": [
    {
      "id": 12,
      "chat_id": 123,
      "action": "ban",
      "actor_user_id": 42,
      "actor_login": "petr",
      "actor_name": "Пётр",
      "actor_avatar_url": null,
      "target_user_id": 99,
      "target_login": "spammer",
      "target_name": "Спамер",
      "target_message_id": null,
      "payload": { "reason": "спам" },
      "created_at": "2026-05-31 10:00:00"
    }
  ]
}

Поле payload уже разобрано из JSON и может быть null.

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

actionОписание
pinСообщение закреплено
unpinЗакрепления сняты
banУчастник заблокирован
unbanБлокировка снята
kickУчастник исключён
promoteНазначен администратор
demoteПрава администратора сняты
custom_title_setЗадано звание администратора
title_changedИзменено название чата
description_changedИзменено описание
photo_changedИзменено или удалено фото
permissions_changedИзменены права участников
message_deletedУдалено чужое сообщение
invite_createdСоздана ссылка-приглашение
invite_revokedСсылка отозвана

Ошибки

КодОписание
400Не передан chat_id
403Бот не в чате или не администратор

pykodaribot

for entry in await bot.get_chat_admin_log(chat_id, limit=20):
    print(entry.created_at, entry.action, entry.actor_user_id, entry.target_user_id)

Поле payload в текущей версии SDK (0.3.0) не заполняется — сервер отдаёт уже разобранный объект в ключе payload, а SDK ищет payload_json. Если нужны детали действия, читайте ответ через bot._get("getChatAdminLog", chat_id=chat_id).

56 просмотров