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

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

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

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

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. - 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".

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

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