Skip to content

Получение 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 Неверные логин и пароль