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

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, который указан в вашем аккаунте на Одноклассниках.

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

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

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

• Через меню Игры - В разработке.
• По ссылке: https://ok.ru/game/{application_id}.

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

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

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

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

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

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

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

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

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

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

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