Получение access token
Метод служит для получения access token.
URL
POST https://rest.lksup.ru/v1/get_access_token
Описание
Метод возвращает access и refresh токены.
Для выполнения запроса необходимо предоставить: - Авторизационные данные — Логин и пароль партнера. - X-API-KEY — API ключ, ранее полученный партнером. - X-Nonce: — значение состоит из случайных символов, используется в шифровании.
Примечание: Перед отправкой убедитесь, что тело запроса зашифровано корректно. Подробнее ознакомиться с информацией о шифровании можно по ссылке
Структура запроса
В HTTP Header необходимо передать x-api-key, x-nonce. В тело запроса помещаются, авторизационные данные, тело запроса необходимо передавать в зашифрованном виде.
Пример запроса
{
"login": "Smth partnerName",
"password": "Smth partnerPassword"
}
Формат запроса:
POST https://rest.lksup.ru/v1/get_access_token
Параметры запроса
| Параметр | Тип | Описание | Обязательный |
|---|---|---|---|
login |
string | Логин партнера в сервисе СУП | Да |
password |
string | Пароль партнера в сервисе | Да |
Структура ответа
Пример успешного ответа - код 200
{
"tokenType": "bearer",
"refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.cThIIoDvwdueQB468K5xDc5633seEFoqwxjF_xSJyQQ",
"refreshExpireAt": 1739923200,
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.KMUFsIDTnFmyG3nMiGM6H9FNFUROf3wh7SmqJp-QV30",
"accessExpireAt": 1739923200
}
Параметры успешного ответа
| Параметр | Тип | Описание |
|---|---|---|
tokenType |
string | Тип токена |
refreshToken |
string | Refresh token |
refreshExpireAt |
int | Срок действия refresh token |
accessToken |
string | Access token |
accessExpireAt |
int | Срок действия access token |
Пример ответа с ошибкой
Ответы с ошибкой могут быть двух видов.
Пример ответа для кода состояния 422
{
"data": [{
"field":"string",
"message":"string"
},
{
"field":"string",
"message":"string"
}]
}
Пример ответа для кодов состояния 4хх, за исключением 422
{
"message": "string"
}
Параметры ответа с ошибкой
| Параметр | Тип | Описание |
|---|---|---|
field |
string | Наименование поля, в котором была допущена ошибка |
message |
string | Текстовое описание ошибки |
Возможные ошибки
| Статус | Описание |
|---|---|
| 400 | Неверные логин и пароль |