--> --> --> -->

Запрос на вход в систему

Все API запросы требуют авторизации. Токен авторизации необходимо отправить в заголовке в следующем формате:

Authorization: Bearer <integrator_token>

Токен авторизации вы получите в ответ на отправленный запрос на вход в систему. Для запроса вам необходимо указать логин и пароль пользователя с ролью INTEGRATOR. Чтобы получить их, обратитесь в службу поддержки.

Если вы продолжите использовать токен после того, как его срок действия истечет, на все запросы будет возвращаться код 401. Чтобы получить новый токен, повторите запрос на вход в систему.

Разрешения

  ----
  Permissions:PERMIT ALL
  ----

Пример curl

$ curl 'http://localhost:8080/api/auth/login' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -d '{
  "login" : "integrator_login",
  "password" : "integrator_password",
  "locale" : "integrator_locale"
}'

Пример HTTP запроса

POST /api/auth/login HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 86
Host: localhost:8080
{
  "login" : "integrator1",
  "password" : "integrator_password",
  "locale" : "ru"
}

Поля тела запроса

ПараметрТипОписание
loginstringЛогин пользователя с ролью INTEGRATOR
passwordstringПароль пользователя с ролью INTEGRATOR
localestring (необязательно)Локализация пользователя (формат en/ru). Не используется для роли INTEGRATOR.

Пример HTTP ответа

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Authorization: Bearer <integrator_token>
Content-Type: application/json
Content-Length: 105
{
    "userId": 1,
    "login": "integrator1",
    "token": "<integrator_token>",
    "role": "INTEGRATION"
}

Поля тела ответа

ПараметрТипОписание
userIdlongИдентификатор пользователя в edna Chat Center (не используется для роли INTEGRATOR)
loginstringЛогин пользователя
tokenstringТокен пользователя. Этот токен необходимо передавать в заголовках запросов требующих аутентификации
rolestringРоль пользователя. Роль определяет права доступа пользователя.