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

put
Добавить объекты
https://api.lotinfo.ru/v1/OBJECTS
Эта конечная точка позволяет добавлять объекты.
Request
Response
Request
Query Parameters
token
required
string
Ваш токен.
Form Data Parameters
encoding
optional
integer
Кодировка.
Значения: 0 - не кодировать, 1 - кодировать. По умолчанию: 0.
Пример закодированных символов: "\u0423\u043a\u0430\u0436".
data
required
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) - Клиенты.
Body Parameters
clients
optional
array
Массив с данными клиентов на этом объекте.

Параметры данных клиента:
- clientID (integer,required) - ID клиента.
Примечание: клиент должен принадлежать пользователю.
- name (string) - Имя клиента.
- lpr (integer) - Лицо принимающее решение (ЛПР).
Значения: 0 - не ЛПР, 1 - ЛПР.
Примечание: Из добавляемых клиентов у одного должен быть указан lpr = 1. 
- doled (string) - Доля.
Формат: 1/3.
Response
200: OK
Пример ответа (на запрос из примера ниже).
В результатах выдачи "id" - это ID созданных объектов.
HTTP/1.1 200 OK
Content-Type: application/json
​
{
  "result": [
    {
      "id": 101
    },
    {
      "id": 102
    }
  ]
}
400: Bad Request
Пример ответа на запрос ошибкой.
(Ответ сервера будет с кодом 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"
        }
      ]
    }
  ]
}
База объектов - Previous
Получение данных по объектам
Next - База объектов
Изменение объекта
Last updated 1 month ago
Добавление объектов

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

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

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