Авторизация

VK Cloud платформасында авторизация үшін қол жеткізу токені пайдаланылады. Ол әрбір API-сұраудың параметрінде беріледі.

Қол жеткізу токенін алудың екі тәсілі бар:

• OAuth — токендер жұбын жасау: қол жеткізу токені және жаңарту токені (refresh token).
• Сервистік токен — пайдалану уақыты бойынша шектелмеген токенді жасау.

1. Өтіңіз VK Cloud жеке кабинетіне.

2. Жобаны таңдаңыз.

3. AI API → Vision API бөліміне өтіңіз. Токендерді алу үшін қажетті ақпарат бар бет ашылады:

   • OAuth endpoint: OAuth-токендерін алуға арналған сұраулардың мекенжайы;
   • OAuth Клиент идентификаторы: сұраудың client_id параметрінде берілуі тиіс аккаунт идентификаторы;
   • OAuth Құпия кілт: сұраудың client_secret параметрінде берілуі тиіс кілт.

4. Токендерді жасаңыз:

    
   curl -X POST --location 'https://mcs.mail.ru/auth/oauth/v1/token'                --header 'Content-Type: application/json'                --data '{"client_id":"<OAUTH_ИДЕНТИФИКАТОР_КЛИЕНТА>","client_secret": "<OAUTH_СЕКРЕТНЫЙ_КЛЮЧ>","grant_type":"client_credentials"}'

Сервер жауабында екі токен болады:

• access_token: сервиске API-сұрауларында пайдалану үшін қол жеткізу токені. Оны бірнеше рет пайдалануға болады, бірақ ол бір сағат бойы жарамды. Токеннің өмір сүру мерзімі аяқталған кезде, жаңасын жасау қажет болады. Жобада бір уақытта 25-тен артық қол жеткізу токені белсенді бола алмайды.
• refresh_token: жаңа қол жеткізу токенін жасауға арналған жаңарту токені. Жобада бір уақытта 25-тен артық жаңарту токені белсенді бола алмайды. Әрбір жаңарту токені кез келген мөлшерде қол жеткізу токендерін жасай алады, бірақ бір мезетте белсенділері 25-тен артық болмауы тиіс.

Жаңарту токені арқылы жаңа қол жеткізу токенін жасау үшін команданы орындаңыз:

 
curl -X POST --location 'https://mcs.mail.ru/auth/oauth/v1/token'             --header 'Content-Type: application/json'             --data '{"client_id":"<OAUTH_ИДЕНТИФИКАТОР_КЛИЕНТА>","refresh_token":"<ТОКЕН_ОБНОВЛЕНИЯ>","grant_type":"refresh_token"}'

Мұнда client_id және refresh_token OAuth-токендерін алу кезеңінде алынған.

1. Өтіңіз VK Cloud жеке кабинетіне.
2. Жобаны таңдаңыз.
3. AI API → Vision API бөліміне өтіңіз.
4. Сервистік токен қосу түймесін басыңыз.
5. Ашылған терезеде токен қолданылатын тапсырмалар түрін таңдаңыз.
6. Жасау түймесін басыңыз. Жаңа токен сервистік токендер тізімінде пайда болады.