Добавление объектов

Добавить объекты

PUT https://api.lotinfo.ru/v1/OBJECTS

Эта конечная точка позволяет добавлять объекты.

Query Parameters

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

Request Body

Name	Type	Description
encoding	integer	Кодировка. Значения: 0 - не кодировать, 1 - кодировать. По умолчанию: 0. Пример закодированных символов: "\u0423\u043a\u0430\u0436".
data*	array	Массив с данными об объектах. Параметры данных объекта: - userId (integer) - ID пользователя. - apiIdExchange (integer) - ID объекта в вашей системе. Примечание: в этом параметре вы можете передать ID объекта в вашей системе, чтобы потом запросить его по этому же ID. - price (integer, required) - Цена. - sumarea (integer, required) - Площадь. - home (integer, required) - Номер дома. - regionId (integer) - ID региона. Примечание: regionId не нужно указывать, если указан cityId, он определится автоматически. - cityId (integer) - ID города. - regionName (string) - Название региона. (Поиск regionId по названию региона.) - cityName (string) - Название города. (Поиск cityId по названию города.) Примечание: поиск по cityName возможен только, если указан regionId или regionName. Примечание: обязательно нужно указать cityId или cityName. - street (integer) - ID улицы. - streetName (string) - Название улицы. (Поиск street по названию улицы.) Примечание: обязательно нужно указать street или streetName. - metro (integer) - Станция метро. Значения: id станций метро. - corp (string) - Корпус дома. - objectType (integer, required) - Тип объекта. Значения: Покупка: 3 - Квартиры, 5 - Комнаты, 6 - Строящееся жилье, 7 - Склады, 8 - Индивидуальное жилье, 12 - Гаражи / паркинги, 13 - Офисы, 17 - Торговые площади, 19 - Земельные участки, 20 - Производственные помещения, 21 - Помещения свободного назначения. Аренда: 4 - Комнаты, 9 - Офисные помещения, 11 - Квартиры, 14 - Коттеджи, дома, 15 - Склады, 18 - Торговые помещения, 22 - Производственные помещения, 23 - Помещения свободного назначения. - oStatus (integer) - Статус объекта. Значения: 0 - Мониторинг, 1 - Маяк, 2 - Реальный объект на продажу, 3 - Реальный объект для внутреннего использования. По умолчанию: 0. - newBuild (integer) - Тип. Значения: 0 - Вторичное жилье, 1 - Новостройка. - invest (integer) - Инвестиционный объект. Значения: 0 - Нет, 1 - Да. - rechange (string) - Обмен. Значения: "yes" - Готовы рассмотреть, "conditions" - Рассматривается с условиями. - rechangeUslType (integer) - Условия обмена. Значения: 1 - Мне нужна доплата, 2 - Готов доплатить. По умолчанию: 2. Примечание: указывается, если rechange = "yes". - rechangeUslMoney (integer) - Сумма доплаты. Формат: сумма в рублях. Примечание: указывается, если rechangeUslType = 2. - rechangeUslComments (string) - Комментарии по условиям обмена. Примечание: указывается, если rechange = "yes". - rechangeUslregionId (integer) - Регион обмена. Значения: id регионов. Примечание: rechangeUslregionId не нужно указывать, если указан rechangeUslcityId, он определится автоматически. - rechangeUslcityId (integer) - Город обмена. Значения: id городов. - rechangeUslregionName (string) - Название региона обмена. (Поиск rechangeUslregionId по названию региона.) - rechangeUslcityName (string) - Название города обмена. (Поиск rechangeUslcityId по названию города.) Примечание: поиск по rechangeUslcityName возможен только, если указан rechangeUslregionId или rechangeUslregionName. - rechangeUsldistrict (integer) - Район обмена. Значения: id районов. - createArchObject (integer) - Создать архивный объект. Значения: 1 - Добавление сразу в архив. - color (integer) - Цвет в системе. Значения: 0, 1, 2, 3, 5, 6, 7, 8. - homeToAdvert (integer) - Выгружать № дома в рекламу. Значения: 0 - Нет, 1 - Да. По умолчанию: 1. - priceToAdvert (integer) - Выгружать стоимость объекта в рекламу. Значения: 0 - Не выгружать, 1 - Выгружать. - lighthouseDateOut (string) - Дата снятия маяка. Примечание: lighthouseDateOut указывается, если oStatus = 1. Формат: дд.мм.гггг. - housed (integer) - Стройка. Значения: id строек. Примечание: если указан housed, то указывать street, home, corp не нужно. Также возможно добавление полей из списка "fields". Следующие параметры описаны ниже в "Body Parameters": - clients (array) - Клиенты.
clients	array	Массив с данными клиентов на этом объекте. Параметры данных клиента: - clientID (integer,required) - ID клиента. Примечание: клиент должен принадлежать пользователю. - name (string) - Имя клиента. - lpr (integer) - Лицо принимающее решение (ЛПР). Значения: 0 - не ЛПР, 1 - ЛПР. Примечание: Из добавляемых клиентов у одного должен быть указан lpr = 1. - doled (string) - Доля. Формат: 1/3.

200 Пример ответа (на запрос из примера ниже). В результатах выдачи "id" - это ID созданных объектов.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "result": [
    {
      "id": 101
    },
    {
      "id": 102
    }
  ]
}

400 Пример ответа на запрос ошибкой. (Ответ сервера будет с кодом 200.)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "errors": [
    {
      "error": 7,
      "error_text": "Неизвестный пользователь: 124.",
      "error_field": "userId",
      "error_array": 0
    }
  ]
}

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

PUT https://api.lotinfo.ru/v1/OBJECTS/?TOKEN={ваш_токен} HTTP/1.1
Content-Type: application/json

{
  "data": [
    {
      "userId": 123,
      "price": 19000000,
      "sumarea": 100,
      "cityId": 107,
      "home": 20,
      "streetName": "Ленинградский",
      "objectType": 3,
      "color": 1,
      "floors": 20,
      "floor": 18
    },
    {
      "userId": 123,
      "price": 20000000,
      "sumarea": 150,
      "regionName": "Московская область",
      "cityName": "Москва",
      "home": 20,
      "streetName": "Ленинский",
      "objectType": 3,
      "color": 1,
      "floors": 20,
      "floor": 19,
      "clients": [
        {
          "clientID": 1001,
          "name": "Первый",
          "doled": "1/2",
          "lpr": 1
        },
        {
          "clientID": 1002,
          "name": "Второй",
          "doled": "1/2"
        }
      ]
    }
  ]
}