Получить токен доступа

Обновлено 13 мая 2024

Скачать спецификацию

POST

/oauth

Возвращает токен доступа для авторизации запросов к API. Токен доступа действителен в течение 30 минут.

В заголовке Authorization нужно передать авторизационные данные — строку, полученную в результате кодирования в base64 идентификатора (Client ID) и клиентского ключа (Client Secret) API.

Консоль запросов автоматически кодирует заданные идентификатор и клиентский ключ.

Как получить токен и авторизационные данные (Client Id и Client Secret) читайте в разделах Быстрый старт для физических лиц и Быстрый старт для ИП и юридических лиц.

Запрос

Header Parameters

RqUID

uuid

required

Возможные значения: Value must match regular expression (([0-9a-fA-F-])36)

Уникальный идентификатор запроса. Соответствует формату uuid4.

Параметр для журналирования входящих вызовов и разбора инцидентов. Для создания уникального идентификатора можно использовать стандартные библиотеки и классы для генерации UUID и GUID.

Пример: 6f0b1291-c7f3-43c6-bb2e-9f3efb2dc98e.

• application/x-www-form-urlencoded

Body

scope
string
required
Возможные значения: [GIGACHAT_API_PERS, GIGACHAT_API_CORP]
Версия API. Возможные значения:
• GIGACHAT_API_PERS — доступ для физических лиц.
• GIGACHAT_API_CORP — доступ для юридических лиц.

Ответы

• 200
• 401

OK

• application/json

• Схема
• Пример из схемы

Schema

access_token

string

Токен для авторизации запросов.

expires_at

int64

Дата и время истечения действия токена в формате Unix time.

{
  "access_token": "eyJhbGci3iJkaXIiLCJlbmMiOiJBMTI4R0NNIiwidHlwIjoiSldUIn0..Dx7iF7cCxL8SSTKx.Uu9bPK3tPe_crdhOJqU3fmgJo_Ffvt4UsbTG6Nn0CHghuZgA4mD9qiUiSVC--okoGFkjO77W.vjYrk3T7vGM6SoxytPkDJw",
  "expires_at": 1679471442
}

Unauthorized

Loading...