Application permissions

NameDescription
VALUABLE_ACCESSThe main permission, necessary to call most methods
LONG_ACCESS_TOKENGetting long access tokens from OAuth
PHOTO_CONTENTAccess to photos
GROUP_CONTENTAccess to groups
VIDEO_CONTENTAccess to videos
APP_INVITEPermission to invite friends to the app by friends.appInvite
GET_EMAILAccess to users email

To request permissions necessary to send the app id and the list of relevant permissions with the description of the case of their use to email api-support@ok.ru

The access token with long lifetime LONG_ACCESS_TOKEN

If the user has given the application permission LONG_ACCESS_TOKEN a token with long lifetime is issued. This token returns in the access_token parameter but its lifetime is increased to 30 days.

Extending access token lifetime occurs:

  1. Automatically when calling any API method if the call is made using the access token with long life. Lifetime is set to 30 days since the last auto-extension, but the extension in order to optimize not occur more than 1 time per day. In repeated API calls during the day, the lifetime will be calculated from the date of the first API call. So if API is regularly using access token will be extended automatically and nothing further should not be done.

  2. Also token can be extended explicitly by API method auth.touchSession. In this case the lifetime is set to 30 days from the time of the method call.

Токен is valid as long as the user does not cancel the authorization API applications on page https://www.ok.ru/settings/oauth or change password.