Как получить ВКонтакте Api ID? Подписка на новости

Приложения групп - это кроссплатформенные приложения, которые запускаются со страницы групп ОК или из публикаций в ленте.
Пользователь может открыть приложение в полной версии сайта, в мобильной версии m.ok.ru и в мобильных приложениях ОК для iOS и Android.
С технической точки зрения, это HTML приложение, запускаемое в iframe на полной версии сайта, во WebView в мобильных приложениях или в отдельной вкладке мобильного браузера.

В процессе разработки своего приложения для групп вам понадобятся следующие руководства:

Регистрация приложения

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

1. Зарегистрироваться на портале ОК и привязать к своему аккаунту email – на этот email будут приходить письма, содержащие регистрационные данные приложений.
2. Получить права разработчика по ссылке https://ok.ru/devaccess .
3. После получения прав разработчика откройте раздел Игры и в левом меню выберите “Мои загруженные”. В списке нажмите Добавить приложение: https://ok.ru/dk?st.cmd=appEdit и нажмите кнопку Добавить платфому.
4. Для регистрация приложения для групп укажите платформы: Web(HTML) , HTML(Mobile) и Приложение для групп . Укажите размеры приложения (они будут применяться для открытия на полной версии сайта).
5. Указать официальную группу приложения и ID топика, в котором подробно рассказывается, как пользоваться и настроить приложение, рассматриваются популярные примеры использования.
6. Указать специфичные для приложения групп параметры: кнопка запуска по-умолчанию, возможность открывать на отдельной странице, устанавливать по прямой ссылке и ограничить приложение только для модераторов групп.

Параметры запуска

Кроме перечисленных при запуске приложения со страницы группы, будут передаваться дополнительные параметры:

Параметр viewer_type (роль пользователя в группе) может иметь следующие строковые значения:

Используя параметр viewer_type вы можете определять роль пользователя, например, чтобы отображать специальный интерфейс для администраторов и модераторов группы.

Дополнительные параметры

Чтобы при запуске передать в приложение произвольные параметры, используйте при генерации ссылки query часть ссылки после символа?, укажите необходимые параметры.

Например,

https://ok.ru/group/1111111111111/app/77777777777?param1=545435345¶m2=HELLO

Данные после? будут переданы при запуске приложения в параметре custom_args .
Запуск приложения со своим кастомными параметрами может использоваться для запуска приложения из публикаций в ленте на конкретное состояние приложения. Например, на конкретный тест, анкету, услугу и т.д.

Отправка личных сообщений

Приложение может отправлять сообщения от имени сообщества, в котором оно установлено, используя Bot API .
Предлагаем такую схему работы:

• Когда приложение будет запущено администратором группы (с viewer_type=ADMIN ), запросить право на отправку личных сообщений от имени группы. Используя Javascript SDK , вызвать виджет запроса пермиссии. Пример вызова:

OKSDK.Widgets.askGroupAppPermissions(‘GROUP_BOT_API_TOKEN’, return_url);

Если администратор нажмет “Разрешить” , в API_callback (см. FAPI JS) или на return_url придет access_token для работы с BotAPI .
Токен можно получить один раз и запомнить на стороне приложения, но администратор может в любой момент его инвалидировать через Настройки группы .

У пользователя запросить разрешение на отправку сообщений от группы, используя Javascript SDK вызвать виджет запроса пермиссии.
Пример вызова:

OKSDK.Widgets.askGroupAppPermissions(‘MESSAGES_FROM_GROUP’, return_url);

• Использовать Bot API для отправки сообщений пользователям.
  Для посылки сообщения необходимо отправить POST запрос в формате JSON на url (используя access_token полученный на первом шаге):

https://api.ok.ru/graph/me/messages/chat:C3ecb9d02a600?access_token=TOKEN

• Отправка текстового сообщения

{ "recipient" : { "user_ids" : [ "user:1111111111111" , "user:222222222222" , "user:3333333333333" ] }, "message" : { "text" : "Привет" } }

• Отправка сообщения с фото

{ "recipient" : { "user_ids" : [ "user:1111111111111" , "user:222222222222" , "user:3333333333333" ] }, "message" : { "attachment" : { "type" : "image" , "payload" : { "url" : "https://st.mycdn.me/res/i/ok_logo.png" } } } }

В одном запросе можно передать максимум 100 получателей сообщения. В ответ придёт JSON массив true/false , кому получилось отправить сообщение.

Публикация постов в ленты пользователей и группу

Для публикации постов в ленты пользователей и группу (в том числе с блоком ссылки на игру с картинкой), предлагаем использовать виджет публикации из Javascript SDK :

OKSDK . Widgets . post ( return_url , { "attachment" : { "media" : [ { "type" : "text" , "text" : "Hello, world!" }, { "type" : "link" , "url" : "http://ok.ru/group/11111111111/app/22222222222?param1=AAAAAAAAAAA" , "imageUrl" : "http//yoursite.com/640x320.png" , "buttonKey" : "ANSWER" } ] }, "groupId" : 777777777777 } );

• Для публикации поста в группу, естественно, приложение должно быть запущено от имени админа или модератора группы.
• Если не передавать groupId, то пост опубликуется в ленту пользователя.
• Размер картинки должен быть не меньше 640x320. Для лучшего отображения на всех платформах без обрезаний рекомендуем использовать горизонтальные картинки с пропорцией сторон 2:1 (идеально именно 640x320).
• Для публикации используется аналогичный формат параметра attachment, как и в методе mediatopic.post .
• Значения для параметра buttonKey: RUN, PLAY, OPEN, LINK, VIEW, READ, CALL, LISTEN, JOIN, WRITE, MORE, BUY, BUY_TICKET, FILL, CONTACT, ANSWER, PASS_TEST, ENROLL

Передача заголовка, описания и картинки при публикации ссылки

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

Заголовок блока ссылки составляется на основе тега: