Справочник: мини-приложения на платформе VK

В документации VK платформа называется «VK Mini Apps». Мини-приложения — это веб-приложения, которые запускаются внутри интерфейса ВКонтакте; клиентская часть — обычные веб-страницы на HTML, JavaScript и CSS, серверная — на любой технологии [12][13]. Факты на этой странице — из документации VK для разработчиков, проверено 30.10.2026.

Где работают. В мобильном приложении ВКонтакте (Android, iOS), в мобильной и полной веб-версии. Мини-приложение можно разместить в каталоге ВКонтакте и в Одноклассниках [12].

Как открывается. У мини-приложения есть собственный адрес с числовым ID, который присваивается при регистрации [13]. Его можно запустить и из сообщества — кнопками или из блока приложений сообщества; при запуске ВКонтакте передаёт приложению параметры (источник запуска, сообщество, чат) вместе с подписью, по которой можно обнаружить подмену [16].

Как создать (по разделу «Первые шаги» [13]):

1. Сделайте проект — например, из шаблона create-vk-mini-app. Подключите библиотеку VK Bridge и в начале работы вызовите событие VKWebAppInit — без него мини-приложение не сможет работать с ВКонтакте.
2. Зарегистрируйте мини-приложение как разработчик — порядок описан в разделе «Первые шаги» документации; тип приложения — «Мини-приложение» [13].
3. Разместите на хостинге с HTTPS — у хостинговой компании, в VK Cloud или на бесплатном хостинге статики для мини-приложений (с ограничениями на размер файлов и частоту обновлений; сервер для обработки данных он не даёт).
4. Откройте доступ. Сразу после регистрации мини-приложение видят только создатель и администраторы. Чтобы открыть его всем, в настройках «Размещение» переключают состояние на «Включено». В Одноклассниках приложение доступно другим пользователям только после модерации.

Библиотека VK Tunnel для отладки, по данным документации, недоступна со 2 октября 2025 года из-за технических работ [13].

Что умеет (через VK Bridge):

• телефон пользователя — только если пользователь сам разрешит в системном окне платформы; разрешение разовое [14];
• QR- и штрихкоды — сканирование камерой, в мобильном приложении на Android и iOS [15];
• хранилище — события VKWebAppStorageSet и VKWebAppStorageGet [13];
• социальные механики — например, публикация историй и вступление в сообщество без выхода из приложения [12].

Монетизация (кратко). По правилам платформы физические товары и услуги продают через платёжные системы; цифровые товары — с ограничениями (в мобильных приложениях VK их продажа не разрешена, кроме согласованных случаев); виртуальные ценности — только во внутренней валюте платформы [17]. Договор с платёжным сервисом заключает владелец приложения; покупателю выдают электронный чек [8]. Сам этот сайт ничего не продаёт и платежи не принимает.

Если приложение собирает персональные данные, его владелец — оператор персональных данных: нужны политика, согласие, если нет другого основания, уведомление Роскомнадзора и защита данных [9]. По правилам VK владелец мини-приложения сам отвечает за персональные данные пользователей: пользовательское соглашение и политику указывают в панели управления приложением, и пользователь принимает их до начала работы [17].