[POST] …/v1/User/Get
Возвращает информацию о пользователях.
Входные параметры
Название | Тип данных | Обязательность | Описание параметра |
---|---|---|---|
ids | Array of int64 | Необязательный | Массив id пользователей |
group_ids | Array of int64 | Необязательный | Массив id групп пользователей |
gender | Enum | Необязательный | Пол пользователя: <None | 1 > - не указан, <Male | 2 > - мужской, <Female | 3 > - женский |
can_authorize | Boolean | Необязательный | Метка пользователя для возможности авторизации в системе |
active | Boolean | Необязательный | Метка пользователя для выполнения действий в системе |
language_code | String | Необязательный | Код языка пользователя |
sort_orders | Array of SortOrders | Необязательный | Сортировака выходных параметров |
search | String | Необязательный | Строка поиска по полям: first_name - имя, middle_name - отчество, last_name - фамилия, main_phone - основной телефон, phones - доп. телефон |
limit | Int32 | Необязательный | Лимит возвращаемых данных при запросе. Значение по умолчанию 10000. Максимальное значение 10000 |
offset | Int32 | Необязательный | Смещение от начала выборки |
Модель сортировки выходных параметров
Название | Тип данных | Обязательность | Описание |
---|---|---|---|
column | Enum | Необязательный | Значение для сортировки: <Id | 1 > - Id пользователя, <FirstName | 2 > - Имя, <MiddleName | 3 > - Отчество, <LastName | 4 > - Фамилия, <Sex | 5 > - Пол, <DateOfBirth | 6 > - Дата рождения, <Address | 7 > - Адрес, <MainPhone | 8 > - Основной телефон, <Phones | 9 > - Доп. телефоны, <Email | 10 > - Email, <Description | 11 > - Доп. описание, <Login | 12 > - Логин, <GroupName | 13 > - Группа пользователей, <CanAuthorize | 14 > - Метка авторизации, <Active | 15 > - Метка активности, <TimeZone | 16 > - Временная зона, <LanguageCode | 17 > - Код языка, <LastUpdate | 18 > - Дата изменения |
direction | Enum | Необязательный | Порядок сортировки: <ASC | 1 > - по возростанию, <DESC | 2 > - по убыванию |
Пример запроса
{
"ids":[1],
"group_ids":[1],
"gender":"Male",
"can_authorize":true,
"active":true,
"language_code":"RUS",
"sort_orders": [
{
"column": "Code",
"direction": "ASC"
}
],
"search": "example",
"limit":1,
"offset":0
}
Выходные параметры
Название | Тип данных | Описание |
---|---|---|
result | Array of User | Массив пользователей |
Пример ответа
{
"ok": true,
"result": [
{
"id": 1,
"full_name": "John Fitzgerald Kennedy",
"main_phone": "998123456789",
"user_group": {
"id": 1,
"parent_id": 1,
"name": "Administrators",
"child_count": 1,
"last_update": 1529755889
},
"enable_hints": true,
"system": true,
"last_update": 1532276019,
"first_name": "John",
"last_name": "Kennedy",
"middle_name": "Fitzgerald",
"sex": "Male",
"date_of_birth": "1993-12-21",
"address": "456 Elm Street, Suite 3, Los Angeles, CA 90001, USA",
"phones": "998123456789",
"email": "example@example.com",
"description": "example",
"login": "Admin",
"can_authorize": true,
"active": true,
"language_code": "RUS"
}
],
"next_offset": 1,
"total": 1
}