VK Cloud logo
Обновлена20 декабря 2023 г. в 05:58

Авторизация

Для авторизации в платформе VK Cloud используется токен доступа. Он передается в параметре каждого API-запроса.

Есть два способа получения токена доступа:

  • OAuth — генерация пары токенов: токена доступа и токена обновления (refresh token).
  • Сервисный токен — генерация токена, не ограниченного по времени использования.

Получение OAuth-токенов

  1. Перейдите в личный кабинет VK Cloud.

  2. Выберите проект.

  3. Перейдите в раздел AI APIVision API. Откроется страница с информацией, необходимой для получения токенов:

    • OAuth endpoint: адрес для запросов на получение OAuth-токенов;
    • OAuth Идентификатор клиента: идентификатор аккаунта, который необходимо передать в параметре client_id запроса;
    • OAuth Секретный ключ: ключ, который необходимо передать в client_secret параметре запроса.
  4. Сгенерируйте токены:

    1curl -X POST --location 'https://mcs.mail.ru/auth/oauth/v1/token' \
    2--header 'Content-Type: application/json' \
    3--data '{
    4"client_id":"<OAuth Идентификатор клиента>",
    5"client_secret": "<OAuth Секретный ключ>",
    6"grant_type":"client_credentials"
    7}'

В ответе сервера будут два токена:

  • access_token: токен доступа для использования в API-запросах к сервису. Он может быть использован многократно, но действителен в течение одного часа. Когда время жизни токена истечет, необходимо будет сгенерировать новый. В проекте одновременно активными могут быть не более 25 токенов доступа.
  • refresh_token: токен обновления для генерации нового токена доступа. В проекте одновременно активными могут быть не более 25 токенов обновления. Каждый токен обновления может сгенерировать любое количество токенов доступа, но не более 25 единовременно активных.

Обновление токена доступа

Чтобы сгенерировать новый токен доступа с помощью токена обновления, выполните команду:

1curl -X POST --location 'https://mcs.mail.ru/auth/oauth/v1/token' \
2--header 'Content-Type: application/json' \
3--data '{
4"client_id":"<OAuth Идентификатор клиента>",
5"refresh_token":"<токен обновления>",
6"grant_type":"refresh_token"
7}'

Здесь client_id и refresh_token получены на этапе генерации OAuth-токенов.

Получение сервисного токена

  1. Перейдите в личный кабинет VK Cloud.
  2. Выберите проект.
  3. Перейдите в раздел AI APIVision API.
  4. Нажмите Добавить сервисный токен.
  5. В открывшемся окне выберите тип задач, для которых будет использоваться токен.
  6. Нажмите Создать. Новый токен появится в списке сервисных токенов.