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

Add_admin_chat

maxapi.methods.add_admin_chat.AddAdminChat(bot, chat_id, admins, marker=None)

Bases: BaseConnection

Класс для добавления списка администраторов в чат через API.

https://dev.max.ru/docs-api/methods/POST/chats/-chatId-/members/admins

Attributes:

Name Type Description
bot Bot

Экземпляр бота, через который выполняется запрос.

chat_id int

Идентификатор чата.

admins List[ChatAdmin]

Список администраторов для добавления.

marker int

Маркер для пагинации или дополнительных настроек. По умолчанию None.

Source code in maxapi/methods/add_admin_chat.py
def __init__(
    self,
    bot: "Bot",
    chat_id: int,
    admins: List[ChatAdmin],
    marker: Optional[int] = None,
):
    self.bot = bot
    self.chat_id = chat_id
    self.admins = admins
    self.marker = marker

fetch() async

Выполняет HTTP POST запрос для добавления администраторов в чат.

Формирует JSON с данными администраторов и отправляет запрос на соответствующий API-эндпоинт.

Returns:

Name Type Description
AddedListAdminChat AddedListAdminChat

Результат операции с информацией об успешности.

Source code in maxapi/methods/add_admin_chat.py
async def fetch(self) -> AddedListAdminChat:
    """
    Выполняет HTTP POST запрос для добавления администраторов в чат.

    Формирует JSON с данными администраторов и отправляет запрос на соответствующий API-эндпоинт.

    Returns:
        AddedListAdminChat: Результат операции с информацией об успешности.
    """

    bot = self._ensure_bot()

    json: Dict[str, Any] = {}

    json["admins"] = [admin.model_dump() for admin in self.admins]
    json["marker"] = self.marker

    response = await super().request(
        method=HTTPMethod.POST,
        path=ApiPath.CHATS.value
        + "/"
        + str(self.chat_id)
        + ApiPath.MEMBERS
        + ApiPath.ADMINS,
        model=AddedListAdminChat,
        params=bot.params,
        json=json,
    )

    return cast(AddedListAdminChat, response)