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

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"
}
]
}
]
}