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

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

POST https://api.lotinfo.ru/v1/USERS

Эта конечная точка позволяет получать списки сотрудников агентства недвижимости.

Query Parameters

Name	Type	Description
token*	string	Ваш токен.

Request Body

Name	Type	Description
nomedia	integer	Не выводить данные о медиафайлах (и документах). Может быть равно 1 или быть не указано. 1 - не выводить данные.
encoding	integer	Кодировка. Значения: 0 - не кодировать, 1 - кодировать. По умолчанию: 0. Пример закодированных символов: "\u0423\u043a\u0430\u0436".
filter	object	Фильтры для поиска. Параметры "filter": - id (integer) - ID сотрудника. - apiIdExchange (integer) - ID сотрудника в вашей системе. Примечание: этот параметр вы указываете при добавлении сотрудника по API. - officeId (integer) - ID офиса. - deptId (integer) - ID отдела. - disabled (integer) - Блокировка. Значения: 0 - Не заблокирован, 1 - Заблокирован.
order	object	Поля сортировки. Параметры "order": - id - ID сотрудника. Значения для всех полей: asc - по возрастанию, desc - по убыванию. По умолчанию: 'id': 'asc'.
projection	array	Выводимые поля. Значения "projection": названия полей, которые необходимо вывести.
limit	integer	Максимальное число выводимых сотрудников. По умолчанию: 3000. Максимальное значение: 3000.
ofset	integer	Сдвиг. По умолчанию: 0.

200 Пример ответа (на запрос из примера ниже).

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 Пример ответа на запрос с ошибкой. (Ответ сервера будет с кодом 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,
  "offset": 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"
    }
  ]
}