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

Обновлено 17 декабря 2024

POST

/oauth

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

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

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

Используйте полученный токен для авторизации запросов на синтез и распознавание речи (синхронный или асинхронный).

Запрос

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

Возможные значения: [SALUTE_SPEECH_PERS, SALUTE_SPEECH_CORP]

Версия API. Возможные значения:

SALUTE_SPEECH_PERS — доступ для физических лиц.
SALUTE_SPEECH_CORP — доступ для юридических лиц.
SBER_SPEECH — устаревшее значение для юридических лиц.

Ответы

application/json

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

Schema

Токен доступа

string

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

expires_at

int64

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

{
  "Токен доступа": "eyJhbGci3iJkaXIiLCJlbmMiOiJBMTI4R0NNIiwidHlwIjoiSldUIn0..Dx7iF7cCxL8SSTKx.Uu9bPK3tPe_crdhOJqU3fmgJo_Ffvt4UsbTG6Nn0CHghuZgA4mD9qiUiSVC--okoGFkjO77W.vjYrk3T7vGM6SoxytPkDJw",
  "expires_at": 1679471442
}