Справочник API | Коды | Права доступа | VK для разработчиков (original) (raw)
Права доступа и приватность
[](#Права доступа)Права доступа
Для вызова методов VK API необходима предварительная авторизация с получением ключа и определённых прав доступа. Эта информация отражена в верхней части страницы с описанием каждого метода.
Права доступа определяют возможность использования ключа для работы с тем или иным разделом данных. Например, для получения номера телефона пользователя нужен ключ доступа с правами phone. Список названий прав доступа, которые необходимы приложению, передаётся в параметре scope в процессе получения ключа доступа.
[](#Ключ доступа пользователя)Ключ доступа пользователя
Если вы создали приложение в сервисе авторизации VK ID, изучите список прав доступа в документации VK ID. Для получения
phoneподтвердите профиль бизнеса.Часть расширенных прав из списка ниже может предоставляться приложению в сервисе авторизации VK ID после индивидуального согласования. Для запроса таких прав напишите на devsupport@corp.vk.com.
Если вы уже запрашивали для вашего приложения доступы из списка прав ниже, делать ничего не нужно — выданные доступы сохраняются.
| Атрибут | Битовые представления | Описание |
|---|---|---|
| notify | (+ 1) (1 << 0) | Разрешение отправлять уведомления пользователю. |
| friends | (+ 2) (1 << 1) | Доступ к друзьям. |
| photos | (+ 4) (1 << 2) | Доступ к фотографиям. |
| audio | (+ 8) (1 << 3) | Доступ к аудиозаписям. |
| video | (+ 16) (1 << 4) | Доступ к видеозаписям. |
| stories | (+ 64) (1 << 6) | Доступ к историям. |
| pages | (+ 128) (1 << 7) | Доступ к wiki-страницам. |
| menu | (+ 256) (1 << 8) | Добавление ссылки на приложение в меню слева. |
| status | (+ 1 024) (1 << 10) | Доступ к статусу пользователя. |
| notes | (+ 2 048) (1 << 11) | Доступ к заметкам пользователя. |
| messages | (+ 4 096) (1 << 12) | Доступ к расширенным методам работы с сообщениями. Это право можно получить для ключа доступа пользователя, полученного в Standalone-приложении через Implicit Flow с правом доступа messages, если вы запрашивали его ранее. Для новых приложений это право не выдаётся. |
| wall | (+ 8 192) (1 << 13) | Доступ к обычным и расширенным методам работы со стеной. |
| ads | (+ 32 768) (1 << 15) | Доступ к расширенным методам работы с рекламным API. |
| offline | (+ 65 536) (1 << 16) | Доступ к VK API в любое время (при использовании этой опции параметр expires_in, возвращаемый вместе с ключом доступа, содержит 0 — ключ доступа бессрочный). Не применяется в Open API. |
| docs | (+ 131 072) (1 << 17) | Доступ к документам. |
| groups | (+ 262 144) (1 << 18) | Доступ к группам пользователя. |
| notifications | (+ 524 288) (1 << 19) | Доступ к оповещениям об ответах пользователю. |
| stats | (+ 1 048 576) (1 << 20) | Доступ к статистике групп и приложений пользователя, где он — администратор. |
| (+ 4 194 304) (1 << 22) | Доступ к email пользователя. | |
| market | (+ 134 217 728) (1 << 27) | Доступ к товарам. |
| phone | (+ 268 435 456) (1 << 28) | Доступ к номеру телефона. |
[](#Ключ доступа сообщества)Ключ доступа сообщества
| Атрибут | Битовые представления | Описание |
|---|---|---|
| stories | (+ 1) (1 << 0) | Доступ к историям сообщества. |
| photos | (+ 4) (1 << 2) | Доступ к фотографиям сообщества. |
| app_widget | (+ 64) (1 << 6) | Доступ к виджетам приложений сообществ. Это право можно запросить с помощью события VKWebAppGetCommunityToken. Подробнее — в разделе Ключ доступа сообщества. |
| messages | (+ 4 096) (1 << 12) | Доступ к сообщениям сообщества. |
| docs | (+ 131 072) (1 << 17) | Доступ к документам сообщества. |
| manage | (+ 262 144) (1 << 18) | Доступ к администрированию сообщества. |
Приватность
Некоторые разделы данных ВКонтакте также могут быть скрыты настройками приватности: например, доступ к видеозаписи только для подписчиков сообщества. В этом случае, даже если есть право доступа video, объект может быть скрыт. Подробнее — в разделе Настройки приватности.