Быстрый старт

Шаг 1. Зарегистрируйте своё приложение

При отправке API-запросов ВКонтакте вам нужно обязательно указывать ключ доступа. ВКонтакте поддерживает несколько видов таких ключей.

Чтобы получить ключ доступа, вам нужно зарегистрировать своё приложение или сайт ВКонтакте. Страница, на которой вы это делаете, зависит от типа вашего приложения. Откройте одну из следующих ссылок в браузере и следуйте инструкциям на экране.

Standalone-приложение или сайт

    ► https://id.vk.com/business/go

Мини-приложение, игра или скилл Маруси

    ► https://vk.com/apps?act=manage

О типах приложений

  • Мини-приложение или игра — приложения этих типов работают внутри пользовательского интерфейса ВКонтакте. Их ещё называют встраиваемыми приложениями. Эти приложения используют информацию о пользователе, который их запустил и не требуют авторизации.

  • Standalone-приложение — любое внешнее приложение, которое будет использовать ВКонтакте API. Такие приложения работают вне интерфейса ВКонтакте.

  • Сайт — веб-сайт, который будет использовать ВКонтакте API либо подключать виджеты ВКонтакте на своих страницах.

  • Скилл Маруси — внешнее приложение, которое будет взаимодействовать с голосовым помощником Марусей.

Токены и ключи доступа

В документации VK ID используется термин «токен», а не «ключ доступа». Эти названия равнозначны.

Шаг 2. Получите ключ доступа

Получение ключей доступа из настроек

После регистрации приложения откроется экран с настройками приложения. Вы найдёте ключ доступа в настройках. Ниже показаны некоторые примеры.

Другие способы

  • Разработчики Standalone-приложений и сайтов, использующих старую систему авторизации OAuth ВКонтакте, а не новую — VK ID, могут получить ключи доступа так, как это описано в разделе Ключи доступа.

  • Если вы используете мини-приложение или игру, то для выполнения API-запросов вы можете использовать ключ доступа, который ВКонтакте передаёт мини-приложению или игре при старте в параметрах запуска. Подробности — в разделах Мини-приложения — Параметры запуска и Игры — Параметры запуска.

  • Игры и мини-приложения могут также запросить ключ доступа с помощью события VKWebAppGetAuthToken библиотеки VK Bridge.

Шаг 3. Выполните запрос

После того как вы получите ключ доступа, передайте его в query-параметре access_token либо в заголовке Authorization.

Пример HTTP заголовка
POST https://api.vk.com/method/status.get?user_id=743784474&v=5.131 HTTP/1.1 Authorization: Bearer vk1.a.8mo8TRf0jm67Nla3W3fFbe9qKhMNNMqg21DQLgaPUj...
Пример параметра access_token
https://api.vk.com/method/status.get?user_id=743784474&v=5.131&access_token=vk1.a.8mo8TRf0jm67Nla3W3fFbe9qKhMNNMqg21DQLgaPUj...

Материалы по теме