Все 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" }
Поля тела запроса
Параметр | Тип | Описание |
login | string | Логин пользователя с ролью INTEGRATOR |
password | string | Пароль пользователя с ролью INTEGRATOR |
locale | string (необязательно) | Локализация пользователя (формат 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" }
Поля тела ответа
Параметр | Тип | Описание |
userId | long | Идентификатор пользователя в edna Chat Center (не используется для роли INTEGRATOR ) |
login | string | Логин пользователя |
token | string | Токен пользователя. Этот токен необходимо передавать в заголовках запросов требующих аутентификации |
role | string | Роль пользователя. Роль определяет права доступа пользователя. |