Bot¶

Bot — основной класс. FastVK расширяет его методом run_polling().

Конструктор¶

Bot(
    token: str,
    group_id: int,
    *,
    storage: BaseStorage | None = None,
    lifespan: AsyncContextManager | None = None,
    api_version: str = "5.199",
)

Параметр	Тип	Описание
`token`	`str`	Токен VK сообщества
`group_id`	`int`	ID VK сообщества
`storage`	`BaseStorage`	FSM хранилище. По умолчанию: `MemoryStorage()`
`lifespan`	async context manager	Хук запуска/остановки
`api_version`	`str`	Версия VK API. По умолчанию: `"5.199"`

Методы¶

start_polling¶

async def start_polling(self, *, skip_updates: bool = False) -> None

Запустить цикл long-polling. Блокирует до вызова stop() или прерывания процесса.

skip_updates=True — выбросить накопившиеся апдейты перед стартом.

stop¶

async def stop(self) -> None

Мягко остановить цикл polling.

get_me¶

async def get_me(self) -> Group

Вернуть информацию о сообществе бота (вызывает groups.getById).

collect¶

async def collect(
    method_class: type[VKMethod],
    *,
    max_total: int = 0,
    items_key: str | None = None,
    count: int = 100,
    offset: int = 0,
    **kwargs,
) -> list[Any]

Автоматически проходит по всем страницам пагинированного VK API метода.

Принимает типизированный класс метода — полный автокомплит в IDE.

from fastvk.methods import GroupsGetMembers, WallGet, MessagesGetHistory

# Все участники группы (авто-пагинация)
members = await bot.collect(GroupsGetMembers, group_id=123, fields="photo_200")

# Последние посты (максимум 500)
posts = await bot.collect(WallGet, owner_id=-123, count=100, max_total=500)

# История чата
history = await bot.collect(MessagesGetHistory, peer_id=2000000001)

Параметр	По умолч.	Описание
`method_class`	—	Типизированный класс VK метода (например `GroupsGetMembers`)
`max_total`	`0`	Ограничить количество (`0` = без лимита)
`items_key`	авто	Ключ ответа со списком элементов (автоопределение)
`count`	`100`	Элементов на страницу
`offset`	`0`	Начальное смещение

get_user¶

async def get_user(self, user_id: int, fields: str = "") -> User

Вернуть информацию о пользователе (вызывает users.get).

user = await bot.get_user(123456)
user = await bot.get_user(123456, fields="photo_200,city")

_call¶

async def _call(self, method: str, **params) -> Any

Низкоуровневый API вызов. Вызывает VKAPIError при ответе с ошибкой.

API пространства имён¶

bot.messages   # MessagesNamespace
bot.users      # UsersNamespace
bot.groups     # GroupsNamespace
bot.wall       # WallNamespace
bot.photos     # PhotosNamespace
bot.docs       # DocsNamespace

Каждое пространство имён имеет типизированные методы, возвращающие разобранные модели. Пример:

msg_id = await bot.messages.send(peer_id=123, message="Привет", random_id=0)
# msg_id: int

user_list = await bot.users.get(user_ids=123456)
# user_list: list[dict]