Перейти к содержанию

GetChats

GetChats(bot, count=None, marker=None)

Bases: BaseConnection

Класс для получения списка чатов.

.. deprecated:: 1.1.0 Начиная с июня 2026 года метод GET /chats больше не поддерживается. API не предоставляет готового способа получить список групповых чатов и каналов, в которые добавлен бот.

https://dev.max.ru/docs-api/methods/GET/chats

Attributes:

Name Type Description
bot

Инициализированный клиент бота.
count

Максимальное количество чатов, возвращаемых за один запрос.
marker

Маркер для продолжения пагинации.
Source code in maxapi/methods/get_chats.py 
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
def __init__(
    self,
    bot: "Bot",
    count: int | None = None,
    marker: int | None = None,
):
    warnings.warn(
        "GetChats устарел: начиная с июня 2026 года GET /chats "
        "больше не поддерживается. API не предоставляет готового "
        "способа получить список групповых чатов и каналов, "
        "в которые добавлен бот.",
        DeprecationWarning,
        stacklevel=2,
    )

    if count is not None and not (1 <= count <= 100):
        raise ValueError("count не должен быть меньше 1 или больше 100")

    super().__init__()
    self.bot = bot
    self.count = count
    self.marker = marker

fetch() async

Выполняет GET-запрос для получения списка чатов.

Returns:

Name Type Description
Chats Chats

Объект с данными по списку чатов.
Source code in maxapi/methods/get_chats.py 
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
async def fetch(self) -> Chats:
    """
    Выполняет GET-запрос для получения списка чатов.

    Returns:
        Chats: Объект с данными по списку чатов.
    """

    bot = self._ensure_bot()

    params = bot.params.copy()

    if self.count:
        params["count"] = self.count

    if self.marker is not None:
        params["marker"] = self.marker

    response = await super().request(
        method=HTTPMethod.GET,
        path=ApiPath.CHATS,
        model=Chats,
        params=params,
    )

    return cast(Chats, response)