VK Mini Apps

VK Mini Apps, разработанные для платформы ВКонтакте, могут работать и в Одноклассниках. Приложения, использующие библиотеку VK Bridge, не требуют дополнительных изменений за исключением некоторых моментов, рассмотренных ниже. Работа со специфическими возможностями платформы и методами API требует дополнительной поддержки в приложении или на сервере.

Все данные, с которыми работает приложение, являются сущностями Одноклассников. На старте приложение получает параметры запуска такие же как и у ВКонтакте. Дополнительный параметр vk_client=ok указывает, что приложение запущено на платформе Одноклассников.

Поддержка VK Connect и VK Pay на данный момент не реализована, но планируется в ближайшее время.

Данные пользователя

Для получения данных пользователя приложению доступны все права доступа VK Mini Apps за исключением:

pages – доступ к wiki-страницам,

docs – доступ к документам.

Мобильные клиенты

Поддержка VK Mini Apps в официальных мобильных клиентах Одноклассников реализована на Android с версии 20.11.9 и на iOS с версии 8.59.

Публикация приложения

Для публикации приложения VK Mini Apps в Одноклассниках необходимо в Панели управления приложением в ВКонтакте включить опцию “Опубликовать в Одноклассниках” и привязать его к пользователю в ОК, подтвердив с помощью OAuth авторизации свой аккаунт и статус разработчика приложения. Приложение появляется на платформе Одноклассников в течении 30 минут и любые изменения синхронизируются также в течении этого времени.

При запуске в Одноклассниках такие приложения получат свой уникальный и отличный от ВКонтакте идентификатор. Секретный ключ остается идентичным приложению в ВКонтакте. Для получения аватара приложения, необходимо загрузить его ВКонтакте размером 576x576. При необходимости вы сможете изменить информацию о приложении (такие как название, описание, аватар и пр.) в настройках приложения в Одноклассниках. Поддержка “режима разработки” (позволяющий указать «URL для разработки») на данный момент в Одноклассниках не реализована, но планируется в ближайшее время. Для полноценной разработки и тестирования приложения в Одноклассниках рекомендуется зарегистрировать отдельное приложение в ВКонтакте.

Следуйте инструкции быстрого запуска приложения в Одноклассниках.

По очевидным причинам любое непримитивное приложение из ВКонтакте не заработает 1 в 1 в Одноклассниках (из-за различий самих сетей, особенностей публичного АПИ и пр.) В таком случае приложение потребует дополнительной доработки. Возможно, понадобиться иметь 2 реализации несовместимого функционала на клиенте и/или даже на сервере, а возможно разработчику будет проще иметь отдельные ветку и инстанс ОК версии приложения, которая максимально переиспользует код основного приложения, но имеет специфичные доработки только для Одноклассников.

Чтобы подать заявку на модерацию и разместить свое приложение в каталоге, выберите одно из ранее загруженных приложений и отправьте его на модерацию. Ознакомиться с общей документацией по правилам регистрации и размещения в Одноклассниках вы можете в разделе Запуск на платформе.

В случае возникших вопросов обращайтесь по адресу api-support@ok.ru.

Таблица совместимости событий VK Bridge в ОК

СобытиеСобытие VK BridgeПлатформаКомментарии по отличиям и порядку взаимодействия
Вызов методов API OKOKWebAppCallAPIMethodiOS
Android
Вызов API методов Одноклассников.
Данное событие и его параметры method, params, request_id и response аналогичны событию VKWebAppCallAPIMethod, в остальном формат входных параметров, результатов, кодов ошибок и пр. соответствует документации REST API Одноклассников.
Включение уведомленийVKWebAppAllowNotificationsiOS
Android
 
Восстановление сервиса из кэшаVKWebAppViewRestoreiOS
Android
 
Вступление в сообществоVKWebAppJoinGroupiOS
Android
 
Выбор контакта из телефонной книгиVKWebAppOpenContactsiOS
Android
 
Вызов диалога ShareVKWebAppShareiOS
Android
 
Вызов карточки контактовVKWebAppGetPersonalCard Не поддерживается
Вызов методов API VKVKWebAppCallAPIMethod Не поддерживается
Вызов списка друзей пользователяVKWebAppGetFriendsiOS
Android
Фото передается в другом размере.
Выключение уведомленийVKWebAppDenyNotificationsiOS
Android
 
Добавление сервиса в избранныеVKWebAppAddToFavorites Не поддерживается
Добавление Mini App в сообществоVKWebAppAddToCommunity Не поддерживается
Закрытие дочернего приложенияVKWebAppCloseiOS
Android
 
Закрытие сервисаVKWebAppViewHideiOS
Android
 
Инициализация VK BridgeVKWebAppInit  
Копирование текста в буфер обменаVKWebAppCopyTextiOS
Android
 
Нативный просмотр изображенийVKWebAppShowImagesiOS
Android
 
Отклик на изменение выбораVKWebAppTaptic
SelectionChanged
iOS 
Отклик на столкновениеVKWebAppTapticImpactOccurrediOS 
Отклик, указывающий на успешность выполнения действияVKWebAppTaptic
NotificationOccurred
iOS 
Открытие другого приложенияVKWebAppOpenAppiOS
Android
необходимо указывать vk app id
Открытие редактора историйVKWebAppShowStoryBox Не поддерживается
Отправка события в сообществоVKWebAppSendPayload Не поддерживается
Подписка на сообщения сообществаVKWebAppAllow
MessagesFromGroup
iOS
Android
 
Получение версии официального приложенияVKWebAppGetClientVersioniOS
Android
Добавлен параметр “app”
Значение параметра для соц. сети Одноклассники = “ok”

В старых версиях android клиента, вместо параметра “app” может встречаться “environment”: “ok”
Получение геопозицииVKWebAppGetGeodataiOS
Android
 
Получение данных профиляVKWebAppGetUserInfoiOS
Android
Фото передается в другом размере.
Получение значения ключаVKWebAppStorageGetiOS
Android
 
Получение информации о фонарикеVKWebAppFlashGetInfoiOS
Android
 
Получение номера телефонаVKWebAppGetPhoneNumberiOS
Android
 
Получение токена пользователяVKWebAppGetAuthTokeniOS
Android
Токен не выдается для:
pages — доступ к wiki-страницам,
docs — доступ к документам.
Получение токена сообществаVKWebAppGetCommunityToken Не поддерживается
Получение e-mailVKWebAppGetEmailiOS
Android
 
Предпросмотр виджета сообществаVKWebAppShowCommunity
WidgetPreviewBox
 Не поддерживается
Публикация записей на стенеVKWebAppShowWallPostBoxiOS
Android
Публикации должна быть в формате json в Одноклассниках.
Работа со статус- и экшн-баромVKWebAppSetViewSettingsiOS
Android
 
Событие платежа в сервисеVKWebAppOpenPayForm Не поддерживается
Установка значения переменнойVKWebAppStorageSetiOS
Android
 
Установка хэшаVKWebAppSetLocationiOS
Android
 
Установка яркости фонарикаVKWebAppFlashSetLeveliOS
Android