Администратор может добавлять новых пользователей в систему. Все новые пользователи будут принадлежать одному вендору. Процесс регистрации нового пользователя аналогичен регистрации нового администратора. Следует использовать API авторизации для работы с новыми пользователями. Доступом пользователя к сервису можно управлять через установку флага "Активен".
Для каждого пользователя можно устанавливать роль:
| Роль | Описание |
|---|---|
| Администратор | Доступ разрешён ко всему, включая управление пользователями |
| Супервайзер | Доступ к созданию заказов, продуктов, выполнению защиты |
| Менеджер продуктов | доступ только к созданию продуктов |
| Менеджер по продажам | доступ только к созданию заказов |
| Разработчик | доступ к выполнению защиты |
Получение списка пользователей
Требуется авторизация.
Входных параметров нет.
GET /v1.0/users
Для запроса доступна сортировка и пагинация. Доступные поля сортировки: name (LastName, FirstName). Значения параметров сортировки и пагинации по умолчанию: sortby=name&direction=asc&offset=0&limit=100.
В запросе имеется опциональный параметр archived=false (archived=true) – для вывода не архивных записей (архивных записей). По умолчанию в запросе выводятся все записи – и архивные, и не архивные.
Возвращает массив users:
{
"users": [
{
"_id": 10026,
"confirmed": true,
"email": "1111@yandex.ru",
"status": true,
"userdetails": {
"_id": 10027,
"firstname": "MD",
"lastname": "BDev",
"lastvisitdate": 0,
"archived": false,
"archivationdate: 0,
"role": {
"_id": 5,
"createorders": false,
"createproducts": false,
"createusers": false,
"manageprotect": true,
"nameeng": "Developer",
"namerus": "Разработчик"
},
"settings": {
"language": 0
}
}}]}
Получение списка ролей
Требуется авторизация.
Входных параметров нет.
GET /v1.0/users/roles
Возвращает массив roles:
{
"roles": [
{
"_id": 2,
"createorders": true,
"createproducts": true,
"createusers": false,
"manageprotect": true,
"nameeng": "Supervisor",
"namerus": "Супервайзер",
"readvendorbalance": true
},
{
"_id": 3,
"createorders": false,
"createproducts": true,
"createusers": false,
"manageprotect": false,
"nameeng": "Product manager",
"namerus": "Менеджер продуктов",
"readvendorbalance": false
},
{
"_id": 4,
"createorders": true,
"createproducts": false,
"createusers": false,
"manageprotect": false,
"nameeng": "Sales manager",
"namerus": "Менеджер по продажам",
"readvendorbalance": false
},
{
"_id": 5,
"createorders": false,
"createproducts": false,
"createusers": false,
"manageprotect": true,
"nameeng": "Developer",
"namerus": "Разработчик",
"readvendorbalance": false
}]}
Создание нового пользователя
Требуется авторизация.
Входные параметры RAW JSON:
{
"username" : "1111@yandex.ru",
"roleId" : 5,
"password": "Eklmn63158515Eklmn",
"passwordConfirm" : "Eklmn63158515Eklmn",
"firstName": "My First Name",
"lastName": "My Last Name",
"companyName": "Aktiv",
"phone" : "+7(495)123-12-12"
}
POST /v1.0/users
Возвращает элемент user:
{
"user": {
"_id": 10065,
"confirmed": false,
"email": "test@test.ru",
"status": true,
"userdetails": {
"_id": 10067,
"firstname": "Test",
"lastname": "Test",
"lastvisitdate": 0,
"archived": false,
"archivationdate: 0,
"role": {
"_id": 5,
"createorders": false,
"createproducts": false,
"createusers": false,
"manageprotect": true,
"nameeng": "Developer",
"namerus": "Разработчик"
},
"settings": {
"language": 0
}
}
}
}
Изменение данных пользователя
Требуется авторизация.
Входные параметры RAW JSON:
{
"roleId" : 5,
"firstName": "My First Name",
"lastName": "My Last Name",
"userIsActive": "false",
"archived": false
}
PUT /v1.0/users/{id}
Возвращает элемент user:
{
"user": {
"_id": 10065,
"confirmed": false,
"email": "test@test.ru",
"status": true,
"userdetails": {
"_id": 10067,
"firstname": "Test",
"lastname": "Test",
"lastvisitdate": 0,
"archived": false,
"archivationdate: 0,
"role": {
"_id": 5,
"createorders": false,
"createproducts": false,
"createusers": false,
"manageprotect": true,
"nameeng": "Developer",
"namerus": "Разработчик"
},
"settings": {
"language": 0
}
}
}
}
Получение списка заказов, которые подтвердил определенный пользователь
Требуется авторизация.
Входных параметров нет.
GET /v1.0/users/{id}/orders
Для запроса доступна сортировка и пагинация. Доступные поля сортировки: number, submitdate. Значения параметров сортировки и пагинации по умолчанию: sortby=number&direction=asc&offset=0&limit=100.
Для запроса доступна фильтрацию по статусу заказа: Submit(1), Revoked(2). По умолчанию в запросе выдаются заказы с любыми статусами.
В запросе имеется опциональный параметр archived=false (archived=true) – для вывода не архивных записей (архивных записей). По умолчанию в запросе выводятся все записи – и архивные, и не архивные.
Возвращает массив orders:
"orders": [
{
"_id": 10049,
...
