Для запроса прав необходимо прислать id приложения и перечень нужных разрешений с описанием кейса их использования на адрес api-support@ok.ru
Доступные права приложения
| Название | Описание |
|---|---|
| VALUABLE_ACCESS | Основное разрешение, необходимо для вызова большинства методов |
| LONG_ACCESS_TOKEN | Получение длинных токенов от OAuth авторизации |
| PHOTO_CONTENT | Доступ к фотографиям |
| GROUP_CONTENT | Доступ к группам |
| VIDEO_CONTENT | Доступ к видео |
| APP_INVITE | Разрешение приглашать друзей в игру методом friends.appInvite |
| GET_EMAIL | Доступ к email адресу пользователя |
Токен доступа с большим сроком жизни LONG_ACCESS_TOKEN
Токен с большим сроком жизни выдаётся, если пользователь выдал приложению право LONG_ACCESS_TOKEN. Данный токен, как и обычный, возвращается в параметре access_token, но его время жизни увеличивается до 30 дней.
Продление токена доступа происходит:
Автоматически при вызове любого метода API, если данный вызов выполнен используя токен доступа с большим сроком жизни. Время жизни устанавливается в 30 дней с момента последнего авто-продления, но продление в целях оптимизации срабатывает не чаще, чем 1 раз в день. Т. е. при повторных вызовах API в течении дня время жизни будет рассчитываться от момента первого вызова API. Таким образом, если API-приложением пользуются регулярно, токен доступа будет продлятся автоматически и ничего дополнительно делать не надо.
Токен также можно продлить явно при помощи вызова API метода auth.touchSession. В данном случае время жизни устанавливается в 30 дней с момента вызова метода.
Длинный токен действителен до тех пор, пока пользователь не отменит авторизацию API-приложения на странице https://www.ok.ru/settings/oauth, либо изменит свой пароль на портале.