MAX API

Что это такое?

MAX API — неофициальная Python-библиотека для мессенджера MAX. Общается с сервером api.oneme.ru:443 по бинарному протоколу (заголовок 10 байт + MessagePack-payload, опционально LZ4).

Есть класс MaxClient, методы-корутины, сессия в JSON, context manager.

Разделы документации

Структура пакета

# Бинарный пакет MAX (10-байтный заголовок)
┌──────────┬──────────┬──────────┬──────────┬──────────────────────────────┐
│ ver (1b) │ cmd (1b) │ seq (2b) │ op  (2b) │ length (4b) │ payload ...  │
└──────────┴──────────┴──────────┴──────────┴──────────────────────────────┘
# payload = msgpack({...})  или  lz4_compress(msgpack({...}))  если >= 32 байт

Быстрый пример

import asyncio
from maxapi import MaxClient

async def main():
    async with MaxClient("my_session") as client:
        # Первый вход — по SMS
        await client.send_code("+79999999999")
        await client.sign_in(input("Код из SMS: "))

        # Профиль и чаты
        me    = client.me             # dict из LOGIN-кэша
        chats = client.cached_chats   # list чатов из LOGIN-кэша

        # Отправить сообщение
        result = await client.send_message(chat_id=34540359, text="Привет!")
        msg = result["message"]
        print(msg.get("msgId") or msg.get("id"))  # ID отправленного сообщения

asyncio.run(main())

Зависимости