Методы (Methods)
GET Прайсы
Параметры запроса
Имя | Обязательность | Описание | Значение по умолчанию | Комментарий |
---|---|---|---|---|
pbi | Обязательный | Персональный токен доступа |
Примечание
Параметр test=true
в запросе необходим для постраничной выгрузки: не более 10 строк. Постраничная выгрузка предотвращает зависание браузера.
Пример запроса
Curl:
curl -X 'GET' \
'https://api.bndev.it/cmap/analytics.json?act=pbi-prices&test=true&pbi=ТОКЕН' \
-H 'accept: application/json'
URL:
https://api.bndev.it/cmap/analytics.json?act=pbi-prices&test=true&pbi=ТОКЕН
Пример ответа
Ответ сервер передает в формате JSON.
{
"status": "ok",
"content": [
{
"id": "1",
"hc_name": "Vitality",
"hc_id_hash": "a54889f5e742726ded95414165c757a5",
"developer": "Larus Capital",
"region": "Москва",
"area": "ЮВАО",
"district": "Южнопортовый",
"metro": "Дубровка",
"building": "1-ая ул. Машиностроения, д. 7, к. 1 Квартиры",
"b_id_hash": "ec5c022c1e7b18038f62f3d4dbdbeb1e",
"section": 1,
"floor": 2,
"numInPlatform": 0,
"numApartment": "1",
"rooms": "3",
"square": "71.2",
"squarePrice": 240449.44,
"price": 17120000,
"discountNote": "Скидок нет",
"discountInPrice": "без скидки",
"interior": "Без отделки",
"object_type": "Квартиры",
"discount": null,
"discount_value": null,
"discount_desc": null,
"decoration": null,
"decoration_desc": null,
"object_class": "Бизнес",
"agreement": "ДДУ без эскроу",
"dsc": "2021-09-30",
"start_sales": "2019-04-01",
"stage": "Монтажные и отделочные работы",
"stage_desc": null,
"construction": null,
"living_square": 0,
"floors_from": null,
"floors_to": null,
"car_spaces_num": null,
"parking_type": null,
"first_lot_date": null,
"first_lot_price_square": 0,
"first_lot_price": 0,
"lot_term": null,
"lot_price_square_rise": 0,
"lot_price_rise": 0,
"first_appearance": null,
"create_time": "2020-10-16 04:45:10",
"source_url": "https://example.url",
"a_lot_hash": "2f4747cae2199f3c413234e763965c01"
}
],
"auth": true
}
Список параметров
Название параметра | Описание | Тип данных | Обязательность |
---|---|---|---|
id | ID записи | числовой, целое | Обязательный |
hc_name | Название проекта/жилого комплекса | текстовый, GUID | Обязательный |
hc_id_hash | ID проекта, в котором находится объект прайса | текстовый, GUID | Обязательный |
developer | Название компании-девелопера | текстовый, до 255 символов | Обязательный |
region | Административные границы, в которых расположен проект | текстовый, до 255 символов | Обязательный |
area | Административные границы, в которых расположен проект | текстовый, до 255 символов | Необязательный |
district | Административные границы, в которых расположен проект | текстовый, до 255 символов | Обязательный |
metro | Станция метро | текстовый, до 255 символов | Обязательный |
building | Номер корпуса жилого комплекса + адрес | текстовый, до 255 символов | Обязательный |
b_id_hash | ID корпуса, в котором находится объект прайса | текстовый, GUID | Обязательный |
section | Номер секции/подъезда, где расположен лот | текстовый, до 255 символов | Обязательный |
floor | Номер этажа жилого комплекса, где расположен лот | текстовый, до 255 символов | Обязательный |
numPlatform | Номер лота на этаже | текстовый, до 255 символов | Обязательный |
numApartment | Условный номер лота в составе ЖК | текстовый, до 255 символов | Обязательный |
rooms | Количество комнат в лоте | текстовый, до 255 символов | Обязательный |
square | Площадь лота | числовой, 3 знака после точки | Обязательный |
squarePrice | Заявленная цена за 1 кв.м. лота | числовой, 2 знака после точки | Обязательный |
price | Заявленный бюжет покупки лота | числовой, 2 знака после точки | Обязательный |
discountNote | Описание скидки на дату сбора данных по корпусу | текстовый, до 65535 символов | Обязательный |
discountPrice | Описание включения скидок в заявленную цену по корпусу | текстовый, до 255 символов | Обязательный |
interior | Тип отделки по корпусу расположения лота | текстовый, до 255 символов | Обязательный |
object_type | Формат лота - квартиры или апартаменты | текстовый, до 255 символов | Обязательный |
discount | Наличие скидки по лоту (при наличии) - значение по уникальному объекту недвижимости | текстовый, до 255 символов | Обязательный |
discount_value | Размер скидки по лоту (при наличии) - значение по уникальному объекту недвижимости | текстовый, до 255 символов | Необязательный |
discount_desc | Описание скидки по лоту (при наличии) - значение по уникальному объекту недвижимости | текстовый, до 255 символов | Необязательный |
decoration | Наличие отделки по лоту (при наличии) - значение по уникальному объекту недвижимости | текстовый, до 255 символов | Обязательный |
decoration_desc | Описание типа отделки по лоту (при наличии) - значение по уникальному объекту недвижимости | текстовый, до 255 символов | Обязательный |
object_class | Класс корпуса расположения лота | текстовый, до 255 символов | Обязательный |
agreement | Тип договора для совершения сделок | текстовый, до 255 символов | Обязательный |
dsc | Планируемая дата ввода в эксплуатацию по корпусу расположения лота | дата, ГГГГ-ММ-ДД | Обязательный |
start_sales | Старт продаж по корпусу расположения лота | дата, ГГГГ-ММ-ДД | Обязательный |
stage | Стадия строительной готовности корпуса, где расположен лот | текстовый, до 255 символов | Обязательный |
stage_desc | Детализация по стадии строительной готовности корпуса, где расположен лот | текстовый, до 255 символов | Обязательный |
construction | Описание типа конструктива корпуса, в котором расположен лот | текстовый, до 255 символов | Обязательный |
living_square | Общая жилая площадь лотов корпуса, в котором расположен лот | числовой, 3 знака после точки | Обязательный |
floors_from | Минимальная этажность корпуса, в котором расположен лот | числовой, целое | Обязательный |
floors_to | Максимальная этажность корпуса, в котором расположен лот | числовой, целое | Обязательный |
car_spaces_num | Количество машино-мест в проекте, в котором расположен лот | числовой, целое | Обязательный |
parking_type | Тип паркинга в проекте, в котором расположен лот | текстовый, до 255 символов | Обязательный |
first_lot_date | Дата первого появления лота в прайсе | дата, ГГГГ-ММ-ДД | Обязательный |
first_lot_price_square | Цена за 1 кв.м. первого появления лота в прайсе | числовой, 2 знака после точки | Обязательный |
first_lot_price | Бюджет покупки первого появления лота в прайсе | числовой, 2 знака после точки | Обязательный |
lot_term | Срок пребывания лота в прайсе на момент последнего исторического слоя, дней | числовой, целое | Обязательный |
lot_price_square_rise | Рост цены за 1 кв.м с первого появления в прайсе | числовой, 6 знака после точки | Обязательный |
lot_price_rise | Рост бюджета покупки с первого появления в прайсе | числовой, 6 знака после точки | Обязательный |
first_appearance | Первое появление в прайс-листе (значения - да / нет) | текстовый, до 255 символов | Обязательный |
create_time | Дата сбора данных | дата, ГГГГ-ММ-ДД | Обязательный |
source_url | Ссылка на источник | текстовый, до 255 символов | Обязательный |
a_lot_hash | ID объекта прайса (лот) | текстовый, GUID | Обязательный |