Приложение

Для получения id и ключей приложения, необходимо его создать по инструкции.

После создания приложения, в него можно добавить пользователей на время разработки, нажмите на ссылку Разработчики и выдайте необходимые права (см. роли пользователей).

Параметры приложения

Приведенные ниже параметры передаются приложениям, открывающимся в iframe:

  • как параметры запроса для HTML-приложений
  • как flashvars для Flash-приложений
НазваниеОбязательныйТипОписание
logged_user_idДаLongИдентификатор авторизованного пользователя, который является постоянным
api_serverДаStringОсновной URL API-сервера, например: https://api.ok.ru/
application_keyДаStringОткрытый ключ приложения
session_keyДаStringКлюч сессии пользователя в приложении
session_secret_keyДаStringСекретный ключ сессии пользователя в приложении
authorizedДаNumber1, если пользователь авторизовал приложение; 0 в ином случае
apiconnectionДаStringИмя соединения
refplaceНетStringСпособ запуска приложения (см. ниже)
refererНетStringИдентификатор способа, зависит от refplace. Для способов, связанных с пользователем, это идентификатор друга
auth_sigДаStringMD5-хеш параметров user+session_key+application_secret_key. Может использоваться для упрощенной проверки вошедшего в систему пользователя
sigДаStringMD5-хеш текущего запроса и application_secret_key
custom_argsНетStringКастомные параметры, передаваемые, когда пользователь открывает кастомную ссылку в ленте друга, принимает приглашение друга или просматривает оповещение от друга
containerНетBooleanБудет передан со значением true, если mobile_html приложение открыто внутри нативного приложения
header_widgetНетStringНазвание мобильного виджета заголовка, который должен быть показан на страницах приложения

Способы запуска приложения

refplaceОписание
directПрямая ссылка (https://ok.ru/games/[short-name])
catalogИз любого места в каталоге приложений или приложениях пользователя (устарело)
bannerИз баннера в каталоге приложений
banner_textИз баннера (текст баннера)
banner_imgИз баннера (картинка баннера)
friend_invitationПользователь принял приглашение друга
friend_feedИз записи в ленте друга
friend_notificationИз оповещения в панели инструментов
presentИз подарка
present_tooltipИз подарка (тултип)
common_apps“Вас объединяет с другом”
user_appsИз каталога: мои приложения
friend_appsИз каталога: приложения друга
recommended_appsИз каталога: рекомендованные приложения
new_appsИз каталога: новые приложения
top_appsИз каталога: топ приложений
pay_attention_appsИз каталога: обратите внимание
app_search_appsИз каталога: поиск по приложениям
shops_catalog_appsИз каталога: магазины и услуги
our_appsИз каталога: наши приложения
short_appsИз каталога: развлечения
app_presetИз тематической подборки приложений
showcase_appsИз каталога: рекомендуемые по жанру
rb_9Ссылка под аватаркой пользователя. Появляется, если пользователь подсел в игру

Для некоторых из способов запуска есть также вариант с префиксом passive_.
Разница между passive и стандартным - в том, откуда именно из UI пользователь запустил игру. В этом случае непассивный вариант - это выскакивающая, независимо от действия пользователя, нотификация, рекомендация и тд, а пассивный - случай, когда элемент не выделен для пользователя особым образом, и запускается стандартно.

Например:

passive_friend_suggest passive_friend_suggest

friend_suggest friend_suggest