Получение данных по сотрудникам

post
Список сотрудников АН

https://api.lotinfo.ru/v1/USERS
Эта конечная точка позволяет получать списки сотрудников агентства недвижимости.
Request
Response
Request
Query Parameters
token
required
string
Ваш токен.
Form Data Parameters
nomedia
optional
integer
Не выводить данные о медиафайлах (и документах). Может быть равно 1 или быть не указано. 1 - не выводить данные.
encoding
optional
integer
Кодировка. Значения: 0 - не кодировать, 1 - кодировать. По умолчанию: 0. Пример закодированных символов: "\u0423\u043a\u0430\u0436".
filter
optional
object
Фильтры для поиска. Параметры "filter": - id (integer) - ID сотрудника. - apiIdExchange (integer) - ID сотрудника в вашей системе. Примечание: этот параметр вы указываете при добавлении сотрудника по API. - officeId (integer) - ID офиса. - deptId (integer) - ID отдела. - disabled (integer) - Блокировка. Значения: 0 - Не заблокирован, 1 - Заблокирован.
order
optional
object
Поля сортировки. Параметры "order": - id - ID сотрудника. Значения для всех полей: asc - по возрастанию, desc - по убыванию. По умолчанию: 'id': 'asc'.
projection
optional
array
Выводимые поля. Значения "projection": названия полей, которые необходимо вывести.
limit
optional
integer
Максимальное число выводимых сотрудников. По умолчанию: 3000. Максимальное значение: 3000.
ofset
optional
integer
Сдвиг. По умолчанию: 0.
Response
200: OK
Пример ответа (на запрос из примера ниже).
HTTP/1.1 200 OK
Content-Type: application/json
{
"result": [
{
"systemId": {
"fieldName": "ID в системе lotinfo",
"fieldType": "key",
"fieldMulti": "not_multi",
"values": [
{
"id": "123"
}
]
},
"lastActive": {
"fieldName": "Последняя активность",
"fieldType": "value",
"fieldMulti": "not_multi",
"values": [
{
"value": "2021-05-14T13:28:23+05:00"
}
]
}
}
]
}
400: Bad Request
Пример ответа на запрос с ошибкой. (Ответ сервера будет с кодом 200.)
HTTP/1.1 200 OK
Content-Type: application/json
{
"errors": [
{
"error": 9,
"error_text": "Укажите одно из доступных значений: 0, 1.",
"error_field": "disabled"
}
]
}

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

POST https://api.lotinfo.ru/v1/USERS?TOKEN={ваш_токен} HTTP/1.1
Content-Type: application/json
{
"limit": 10,
"filter": {
"officeId": 150
},
"projection": ["systemId", "lastActive"]
}

Кастомные поля

Интересы

"fieldType": "interests"

name - Название поля, value - Значение.

"interests": {
"fieldName": "Интересы",
"fieldType": "interests",
"fieldMulti": "multi",
"values": {
"Activities": {
"name": "Деятельность",
"value": ""
},
"Interest": {
"name": "Интересы",
"value": ""
},
"Music": {
"name": "Любимая музыка",
"value": ""
},
"Film": {
"name": "Любимые фильмы",
"value": ""
},
"TVshow": {
"name": "Любимые телешоу",
"value": ""
},
"Books": {
"name": "Любимые книги",
"value": ""
},
"Games": {
"name": "Любимые игры",
"value": ""
},
"Quotes": {
"name": "Любимые цитаты",
"value": ""
},
"AboutYourSelf": {
"name": "О себе",
"value": ""
}
}
}

Сертификаты

"fieldType": "certificate"

id - ID файла. certificate - Ссылка на сертификат. name - Название сертификата.

"certificates": {
"fieldName": "Сертификаты",
"fieldType": "certificate",
"fieldMulti": "multi",
"values": [
{
"id": "12345",
"certificate": "https:\/\/files.lotinfo.ru\/usersFiles\/4f75.jpg",
"name": "Программирование на Python"
}
]
}

Отзывы клиентов

"fieldType": "opinion"

id - ID файла. opinion - Ссылка на отзыв.

"opinions": {
"fieldName": "Отзывы клиентов",
"fieldType": "opinion",
"fieldMulti": "multi",
"values": [
{
"id": "1008",
"opinion": "https:\/\/files.lotinfo.ru\/usersFiles\/c032d.jpg"
}
]
}

Карьера

"fieldType": "career"

id - ID карьеры. country - Страна. city - Город. name - Компания. yearStart - Год начала работы. yearEnd - Год окончания работы. appointment - Должность.

"career": {
"fieldName": "Карьера",
"fieldType": "career",
"fieldMulti": "multi",
"values": [
{
"id": "12",
"country": "Россия",
"city": "Санкт-Петербург",
"name": "Компания",
"yearStart": "2015",
"yearEnd": "2018",
"appointment": "Менеджер проектов"
}
]
}

Образование

"fieldType": "education"

id - ID образования. type - Тип образования. country - Страна. city - Город. name - Название учреждения. yearStart - Год начала обучения. yearEnd - Год окончания обучения. profession - Специальность.

"education": {
"fieldName": "Образование",
"fieldType": "education",
"fieldMulti": "multi",
"values": [
{
"id": "14",
"type": "ВУЗ",
"country": "Россия",
"city": "Москва",
"name": "Гуманитарный университет",
"yearStart": "2010",
"yearEnd": "2014",
"profession": ""
}
]
}

Документы по сотруднику

"fieldType": "media"

link - Ссылка на документ. typeContent - Тип контента.

"documents": {
"fieldName": "Документы по сотруднику",
"fieldType": "docs",
"fieldMulti": "multi",
"values": [
{
"link": "https:\/\/files.lotinfo.ru\/usersFiles\/6c0f.jpg",
"typeContent": "image"
}
]
}