maxapi-lite

Легковесный асинхронный клиент MAX Bot API, совместимый с aiohttp 3.8.x.

Пакет нужен, когда в проекте уже зафиксирован старый aiohttp — например, рядом живёт aiogram 2.x (aiohttp<3.9), а официальный клиент maxapi требует aiohttp>=3.12. Зависимости — только aiohttp>=3.8 и pydantic>=2.

Lightweight async client for the MAX messenger Bot API that works with aiohttp 3.8, so it can share an environment with aiogram 2.x.

Установка

pip install maxapi-lite

Быстрый старт

import asyncio
from maxapi_lite import Bot, ParseMode


async def main():
    bot = Bot(token="YOUR_MAX_TOKEN", parse_mode=ParseMode.HTML)  # или переменная окружения MAX_BOT_TOKEN

    # Кнопка-ссылка
    kb_attachment = bot.build_link_button_attachment(
        text="Открыть MiniApp",
        url="https://example.com/app?startapp=123",
    )

    # Отправка фото + кнопки
    result = await bot.send_message_with_media(
        chat_id=-70893181482276,
        text="<b>Розыгрыш</b>",
        media_type="photo",
        file_path="banner.jpg",  # или media_url="https://..."
        attachments=[kb_attachment],
    )

    # Извлечение mid и закрепление
    mid = bot.extract_message_id(result)
    if mid:
        await bot.pin_chat_message(chat_id=-70893181482276, message_id=mid)

    await bot.close_session()


asyncio.run(main())

Long polling

marker = None
while True:
    data = await bot.get_updates(timeout=30, marker=marker)
    for update in data.get("updates", []):
        ...
    marker = data.get("marker", marker)

Методы Bot

Методы возвращают «сырые» dict из ответа API. Ошибки API поднимаются как MaxApiError (с полем code), ошибка авторизации — как InvalidToken.

Поддерживаемые media_type

• photo, animation, image → загрузка как image
• video
• document, file

Примечания

• chat_id / user_id передаются query-параметрами, как требует MAX API.
• edit_message(..., attachments=[]) явно очищает вложения; attachments=None оставляет их как есть.
• Формат (parse_mode) применяется к редактированию только если передан text.
• Для upload используется multipart-поле data.

Разработка

pip install -e ".[test]"
pytest

Релиз: поднять __version__ в src/maxapi_lite/__init__.py, дополнить CHANGELOG.md, создать GitHub Release с тегом vX.Y.Z — workflow publish.yml соберёт пакет и опубликует его на PyPI.

Лицензия

MIT