Authorization Code Flow для получения Access token сообщества

Authorization Code Flow используется для вызова методов API ВКонтакте с серверной части вашего приложения, например из PHP. Access token, полученный таким способом, не привязан к IP-адресу. Как получить список администрируемых сообществ Получить ключ доступа сообщества через OAuth может только его администратор. Чтобы получить токены сразу для всех или нескольких сообществ пользователя, рекомендуем добавить этот дополнительный шаг в процесс авторизации.

Запросите доступ для работы с сообществами (groups) через обращение в техническую поддержку — напишите на почту devsupport@corp.vk.com.
Получите Access token по OAuth VK ID пользователя с правами scope=groups.
Сделайте запрос к методу groups.get с параметром filter=admin, чтобы получить список идентификаторов администрируемых сообществ.
Используйте полученные значения в качестве параметра group_ids.

Обратите внимание
Подготовка group_ids происходит через OAuth 2.1 При этом получение Access token сообщества происходит через OAuth ВКонтакте.

Шаг 1. Как открыть диалог авторизации

Перенаправьте браузер пользователя по адресу https://oauth.vk.com/authorize, передав следующие параметры:

client_id (обязательный) — идентификатор вашего приложения.
redirect_uri (обязательный) — адрес, на который будет передан code. Должен в точности совпадать с тем адресом, который был указан в настройках приложения, включая схему и путь.
group_ids (обязательный) — идентификаторы сообществ, для которых необходимо получить Access token. Параметр должен представлять собой строку, которая содержит значения без знака «минус». Они должны быть разделены запятой.
display — тип отображения страницы авторизации. Возможны варианты: page — форма авторизации в отдельном окне, popup — всплывающее окно, mobile — авторизация для мобильных устройств без использования Javascript.
scope — битовое представление настроек доступа приложения, которые проверяются при авторизации пользователя. Отсутствующие доступы запрашиваются.
response_type — тип ответа, который вы хотите получить. Укажите code.
v (обязательный) — версия API, которую вы используете. Актуальная версия: 5.199.
state — произвольная строка, которая вернется вместе с результатом авторизации.

Пример запроса: https://oauth.vk.com/authorize?client_id=1&display=page&redirect_uri =http://example.com/callback&group_ids=123,321&scope=messages&response_type=code&v=5.199 Если пользователь не вошел на сайт, то в диалоговом окне ему будет предложено ввести свой логин и пароль.

Шаг 2. Как происходит работа с правами доступа

После успешного входа на сайт пользователю будет предложено авторизовать приложение, разрешив доступ к необходимым настройкам, которые запрашиваются с помощью параметра scope. Сейчас для токенов сообщества приложение любого типа может запрашивать права manage, messages, photos, docs.

Шаг 3. Как получить code

После успешной авторизации приложения браузер пользователя перенаправляется по адресу redirect_uri, указанному при открытии диалога авторизации. При этом код для получения Access token code будет передан в GET-параметре на указанный адрес: REDIRECT_URI?code=7a6fa4dff77a228eeda56603b8f53806c883f011c40b72630bb50df056f6479e52a Параметр code можно использовать в течение 1 часа для получения access_token с вашего сервера. Если возникнут ошибки, браузер пользователя будет перенаправлен с кодом и описанием ошибки: REDIRECT_URI?error=invalid_request&error_description=Invalid+display+parameter

Шаг 4. Как получить Access token сообщества

Для получения access_token выполните запрос с вашего сервера на https://oauth.vk.com/access_token, передав следующие параметры:

client_id (обязательный) — идентификатор вашего приложения;
client_secret (обязательный) — защищенный ключ вашего приложения из его настроек;
redirect_uri (обязательный) — URL, который использовался при получении code на первом этапе авторизации. Должен быть аналогичен переданному при авторизации;
code (обязательный) — временный код, полученный после прохождения авторизации.

Пример запроса: https://oauth.vk.com/access_token?client_id=1&client_secret=H2Pk8htyFD8024mZaPHm&redirect_uri =http://mysite.ru&code=7a6fa4dff77a228eeda56603b8f53806c883f011c40b72630bb50df056f6479e52a В результате выполнения запроса ваш сервер получит JSON:

{
   "access_token_123456": "****",

   "access_token_654321": "****",

   "groups": [
    {
      "group_id": 123456,
      "access_token": "****"
    },
    { 
      "group_id": 654321,
      "access_token": "****"
    }
]

   "expires_in": 0

}

В поле groups возвращается массив объектов с group_id, которое является идентификатором сообщества, и access_token, которое является Access token сообщества. При возникновении ошибок будут переданы параметры error и error_description.

{
  "error": "invalid_grant",
  "error_description": "Code is expired."
}