Добавление заявок

put
Добавить заявки

https://api.lotinfo.ru/v1/ORDERS
Эта конечная точка позволяет добавлять заявки.
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. - oStatus (integer) - Статус заявки. Значения: 0 - Мониторинг, 2 - Реальная заявка на подбор, 3 - Реальная заявка для внутреннего использования. - objectType (integer) - Тип объекта. Значения: Покупка: 3 - Квартиры, 5 - Комнаты, 6 - Строящееся жилье, 7 - Склады, 8 - Индивидуальное жилье, 12 - Гаражи / паркинги, 13 - Офисы, 17 - Торговые площади, 19 - Земельные участки, 20 - Производственные помещения, 21 - Помещения свободного назначения. Аренда: 4 - Комнаты, 9 - Офисные помещения, 11 - Квартиры, 14 - Коттеджи, дома, 15 - Склады, 18 - Торговые помещения, 22 - Производственные помещения, 23 - Помещения свободного назначения. - dateStartFind (string) - С какой даты актуально. Формат: дд.мм.гггг. - rentLong (integer) - Тип аренды. Значения: 1 - Краткосрочная аренда, 2 - Долгосрочная аренда, 3 - Посуточная аренда. По умолчанию: 2. Примечание: указывается, если в objectType выбран тип аренды. - advSources (array) - Выбор сайтов объявлений. Значения: id сайтов объявлений. - desc (string) - Описание - price (integer) - Цена за объект (нижний порог). - price_DO (integer) - Цена за объект (верхний порог). - price_2 (integer) - Цена за квадратный метр (нижний порог). - price_2_DO (integer) - Цена за квадратный метр (верхний порог). Примечание: указывается либо price и price_DO, либо price_2 и price_2_DO. - mlsValue (integer) - Значение МЛС (нижний порог). - mlsValue_DO (integer) - Значение МЛС (верхний порог). - doles - - createArchObject (integer) - Сделать заявку архивной. Значения: 1 - Сделать архивной. - regionId (integer) - ID региона. Примечание: regionId не нужно указывать, если указан cityId, он определится автоматически. - cityId (integer) - ID города. - regionName (string) - Название региона. (Поиск regionId по названию региона.) - cityName (string) - Название города. (Поиск cityId по названию города.) Примечание: поиск по cityName возможен только, если указан regionId или regionName. Примечание: обязательно нужно указать cityId или cityName. - street (array) - Улицы. Значения: id улиц. - streetName (array) - Названия улиц. (Поиск street по названию улиц.) Значения: названия улиц. - district (array) - Районы. Значения: id районов. - districtAdm (array) - Административные районы. Значения: id административных районов. - doles (string) - Доля. Формат: 1/2. - fromBuilder (integer) - От застройщика. Значения: 0 - Не важно, 1 - Исключить объекты от застройщика, 2 - Только от застройщика. - newBuild (integer) - Новое жилье. Значения: 0 - Не важно, 1 - Новостройка, 2 - Вторичное жилье. - viewOpen1 (integer) - Подбор только в моём АН (открытые). Значения: 0 - Нет, 1 - Да. По умолчанию: 1. - viewOpen2 (integer) - Подбор только от АН (открытые). Значения: 0 - Нет, 1 - Да. По умолчанию: 1. - viewOpen3 (integer) - Подбор только от собственников (с внешних сайтов). Значения: 0 - Нет, 1 - Да. По умолчанию: 1. - viewOpen4 (integer) - Подбор только от АН (с внешних сайтов). Значения: 0 - Нет, 1 - Да. По умолчанию: 0. - client (object) - Клиент. Параметры: - id (integer) - ID клиента. Примечание: клиент должен принадлежать пользователю. - name (string) - Комментарий. Также возможно добавление полей из списка "fields".
Response
200: OK
Пример ответа (на запрос из примера ниже).
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/ORDERS/?TOKEN={ваш_токен} HTTP/1.1
Content-Type: application/json
{
"data": [
{
"userId": 123,
"cityId": 1067,
"objectType": 3,
"desc": "Описание 1",
"street": [855580],
"streetName": ["проспект вернадского", "ленинский проспект"],
"balcony": 10,
"advSources": [1273, 9]
"client": {
"id": 1001
}
},
{
"userId": 123,
"cityId": 1067,
"objectType": 3,
"desc": "Описание 2",
"street": [855581],
"client": {
"id": 1002
}
}
]
}