Для добавления приложения на сайт Одноклассники необходимо:

  1. Зарегистрироваться на портале Одноклассники и привязать к своему аккаунту email – на этот email будут приходить письма, содержащие регистрационные данные приложений.
  2. Получить права разработчика тут или по ссылке https://ok.ru/devaccess.

После получения прав разработчика откройте раздел Игры, в верхнем меню выберите “В разработке”.

В разделе моих загруженных игр нажмите на “Добавить приложение”.

Заполните форму:

  • название – имя приложения в каталоге и при приглашениях в приложение.
  • имя в ссылке – уникальное короткое имя, обязательно только латиницей и без спец-символов.
  • описание – описание вашего приложения, которое может быть использовано в рекламных целях (максимально 250 символов).

На этом этапе ваше приложение будет создано и вам на почту придут все необходимые для работы с API и для доступа к настройкам приложения ключи

Подключение других платформ

В зависимости от того, что за приложение вам требуется, вам надо подключить определенную платформу:

  • OAuth – если приложение будет использоваться: для OAuth-авторизации, для автопостинга в группу / ленту пользователя;
  • Web – если ваше приложение / игра будет запускаться пользователями на ok.ru;
  • Мобильное – если ваше приложение / игра будет запускаться пользователями на наших мобильных платформах: m.ok.ru, приложения ОК на платформах android и iOS;
  • Группа – дополнительная платформа, подключаемая вместе с платформами Web и Мобильное. Его надо подключить, если вы планируете создать групповое приложение.

Для добавления платформы вам необходимо нажать на кнопку “Добавить платформу” в самом низу настроек приложения:

Платформа OAuth

Если вам требуется сделать приложения для автопостинга, либо OAuth-авторизации с использованием профиля пользователя из ОК в вашем приложении, либо на сайте, то вам надо подключить именно эту платформу.

При подключении платформы вам надо заполнить два поля:

  • Ссылка на страницу (необязательное) – сайт, на котором будет использоваться виджет OAuth-авторизации;
  • Список разрешённых redirect_uri – список страниц, на которые может быть переправлен пользователь после прохождения OAuth-авторизации:
    • каждая страница должна быть указана на отдельной строке;
    • для авторизации в приложении на платформе android необходимо указать URL в таком формате: okauth://ok{APP_ID};
    • для авторизации в приложении на платформе iOS необходимо указать URL в таком формате: ok{APP_ID}://authorize.

Платформы Web и Мобильное

Если вы разрабатываете приложение / игру, и планируется его запускать на нашей веб-платформе (ok.ru), то вам необходимо добавить платформу WEB.

Если вы разрабатываете приложение / игру, и планируется его запускать на наших мобильных платформах (m.ok.ru, android, iOS), то вам необходимо добавить платформу Мобильное.

В обоих случаях вам надо:

  • указать ссылку, по которой будет доступно приложение (для каждой платформы отдельно);
  • загрузить две картинки – 512x512 и 1280x720;
  • заполнить следующий список полей:
    • размер приложения – размер фрейма с приложением на вебе (ширина от 100 до 760px, высота от 100 до 4000px). На мобильных платформах приложение всегда открывается в полный экран;
    • официальная группа – группа, к которой будет привязано приложение. Ссылка на группу будет показываться на странице приложения, а ссылка на игру может быть размещена над лентой группы;
    • ID темы в официальной группе игры – тема, ссылка на которую будет показываться в карточке игры на всех платформах. Топик должен быть публичным;
    • ID видео в официальной группе игры – видео, которое будет использоваться как рекламное видео игры на витрине игр на вебе. Должно быть публичным;
    • ссылка на службу поддержки – приложение может указать URL службы поддержки для прямой отправки отчетов о проблемах с экрана справки портала;
    • ссылка callback – ссылка на ваш платёжный скрипт (более подробная информация callbacks.payment);
    • IP адреса сервера – запрос через REST API несессионных методов допускается только с перечисленных IP адресов.

Групповые приложения

Это дополнительная платформа, подключаемая вместе с платформами WEB и/или Мобильное.

Групповые приложения это приложения, которые запускаются не как автономные приложения, а как встроенное в группу приложение.

Подробная информация о групповых приложениях доступна по этой ссылке.

Ключи приложения

Если вы сделали всё правильно, то вы получите набор ключей и ID приложения на email, который указан в вашем аккаунте на Одноклассниках.

Ваше приложение на Одноклассниках создано!

Доступ к настройкам приложения

Доступ к приложению можно получить:

Для доступа к настройкам приложения нажмите внизу ссылку “Изменить настройки приложения”:

Введите секретный ключ приложения (приходил в письме с данными) в появившийся блок:

Получение токенов доступа для создателя приложения

Если у вашего приложения не хватает прав, то после их добавления у сгенерированных токенов их все еще не будет. Необходимо перегенерировать токены доступа после получения новых прав приложения

Для получения токенов (access_token и session_secret_key) доступа к приложению от имени своего пользователя необходимо:

  • Создать приложение, подключив платформу OAuth, или изменить и сохранить настройки имеющегося приложения

  • Найти внизу страницы настроек приложения блок для генерации “Вечного access_token”:

  • Получить сгенерированную пару access_token и session_secret_key и сохранить в укромное место

Режим разработчика

Обратите внимание, что указанный в настройках URL будет основным для всех пользователей с правами разработчика вашей игры и приложения независимо от его роли - тестировщик, разработчик и другие

Для удобства разработки приложения в настройках поддерживается режим разработки. Включив данный режим, вы можете указать отдельные URL вашей игры и приложения для каждой из платформ.

Для включения режима разработчика вам необходимо:

  • Открыть настройки приложения.
  • Найти нужную вам платформу. Например для веба это “Настройки приложения на портале”.
  • Включить режим разработки, поставив галку у настройки “Режим разработки”.
  • Указать отдельный URL для разработчиков приложения в появившемся поле “Ссылка на приложение для разработчиков”