Права приложения

НазваниеОписание
VALUABLE_ACCESSОсновное разрешение, необходимо для вызова большинства методов
LONG_ACCESS_TOKENПолучение длинных токенов от OAuth авторизации
PHOTO_CONTENTДоступ к фотографиям
GROUP_CONTENTДоступ к группам
VIDEO_CONTENTДоступ к видео
APP_INVITEРазрешение приглашать друзей в игру методом friends.appInvite
GET_EMAILДоступ к email адресу пользователя

Для запроса прав необходимо прислать id приложения и перечень нужных разрешений с описанием кейса их использования на адрес api-support@ok.ru

Токен доступа с большим сроком жизни LONG_ACCESS_TOKEN

Токен с большим сроком жизни выдаётся, если пользователь выдал приложению право LONG_ACCESS_TOKEN. Данный токен, как и обычный, возвращается в параметре access_token, но его время жизни увеличивается до 30 дней.

Продление токена доступа происходит:

  1. Автоматически при вызове любого метода API, если данный вызов выполнен используя токен доступа с большим сроком жизни. Время жизни устанавливается в 30 дней с момента последнего авто-продления, но продление в целях оптимизации срабатывает не чаще, чем 1 раз в день. Т. е. при повторных вызовах API в течении дня, время жизни будет расчитываться от момента первого вызова API. Таким образом, если API приложением пользуются регулярно, токен доступа будет продлятся автоматически и ничего дополнительно делать не надо.

  2. Токен также можно продлить явно при помощи вызова API метода auth.touchSession. В данном случае время жизни устанавливается в 30 дней с момента вызова метода.

Длинный токен действителен до тех пор, пока пользователь не отменит авторизацию API приложения на странице https://www.ok.ru/settings/oauth, либо изменит свой пароль на портале.