Home New buildings Кабинет

Documentation API

Полное руководство по интеграции с платформой «ДваУгла». Примеры запросов, параметры ответов и лучшие практики.

API Terms of Use

Content

1. Authentication
2. Rate Limiting
3. Safety
4. Error Handling
5. Ads

1 Authentication

To access protected data, use the authorization token in the header.:

Authorization: Bearer YOUR_API_TOKEN
Content-Type: multipart/form-data

Token: Get a token in your personal account on the page: https://dvaugla.ru/user/api-tokens
Type: Used Laravel Sanctum.

2 Rate Limiting

Maximum number of requests per minute: 20.

3 Safety

Use HTTPS for all requests.
Tokens are stored in encrypted form.

4 Error Handling

Code	Name	Description
200	OK	The request was completed successfully and the data was returned
201	Created	POST-The request was completed successfully, the record was created
401	Unauthorized	The token is missing, expired, or invalid
403	Forbidden	No rights to access the resource
404	Not found	The requested resource does not exist (e.g. a non-existent property)
422	Validation error	The request data was not validated (e.g., invalid form fields)
429	Too many requests	Request limit exceeded (>60/min with token)
500	Internal Server Error	Server-side error. Please check the logs or try your request again later

Sample answers

200 Ok :

{ "success": true, "message": "Операция выполнена успешно", ... }

201 Created :

{ "success": true, "message": "Операция выполнена успешно", "data": { ... } }

401 Unauthorized :

{ "success": false, "message": "The token is missing, expired, or invalid", "error": "Unauthenticated" }

403 Forbidden :

{ "success": false, "message": "No rights to access the resource", "error": "Forbidden" }

404 Not found :

{ "success": false, "message": "Object not found", "error": "Record not found" }

422 Validation error :

{ "success": false, "message": "Data validation error", "errors": { "title": ["This field is required"] }, "error": "Unprocessable Entity" }

429 Too many requests :

{ "success": false, "message": "Request limit exceeded. Please try again in 10 seconds.", "error": "Too Many Requests" }

500 Внутренняя ошибка :

{ "success": false, "message": "A server error occurred", "error": "Internal Server Error" }

Tips for handling errors:

• Для 401: Check the token and its expiration date.
• Для 403: Make sure the user has access rights.
• Для 404: Check the object ID.
• Для 422: Please refine your request details (e.g. field validation).
• Для 429: Use Retry-After header for repeated requests.
• Для 500: Свяжитесь с администратором или проверьте логи сервера.

5.1 Search ads

URL: GET https://dvaugla.ru/api/v1/ads

Возвращает список всех объектов недвижимости с возможностью фильтрации и пагинации.

Параметры запроса

Параметр	Type	Description
page	integer	Номер страницы для пагинации.
per_page	integer (5-100)	Количество объектов на странице. По умолчанию: 25.
user_rid	string (16)	id авторов объявления. Можно указать сразу нескольких авторов через запятую. Для отображения собственных объявлений можно указать параметр: my_id. По умолчанию возвращаются объявления всех авторов.
type	string (255)	Тип объекта. Доступны значения: Flat House Parking space Storage room Garage Territory Office . Можно указать сразу несколько значений через запятую.
action	string (255)	Операция с объектом. Доступны значения: Sell For rent Exchange Donate . Можно указать сразу несколько значений через запятую.
material	string (255)	Материал стен: not specified Brick Monolithic Panel Wooden Block Tin other . Можно указать сразу несколько значений через запятую.
tariff	string (255)	Тарифный план. Доступны значения: Free Premium Можно указать сразу несколько значений через запятую.
state	string (255)	Статус объявления на сайте. Доступны значения: Active Draft Completed . Можно указать сразу несколько значений через запятую.
period	string (255)	За какой период оплата. Доступны значения: in total per month per day per hour . Можно указать сразу несколько значений через запятую.
min_price	int	Min price
max_price	int	Max price
min_total_area	float	Минимальная общая площадь (м²)
max_total_area	float	Максимальная общая площадь (м²)
min_floor	int	Минимальный этаж
max_floor	int	Максимальный этаж
sort	enum	Сортировка по полю: type action material tariff state period
order	enum	Направление сортировки: asc desc

Пример запроса с дополнительными полями

http://dvaugla.ru/api/v1/ads?page=1&per_page=5&user_rid=my_id,555&material=Монолитный&state=Черновик,Активное&type=Дом,Квартира&tariff=Бесплатный,Премиум&action=Продать,Сдать&period=за всё,за час&min_price=400&max_price=40000000&min_floor=5&max_floor=40&min_total_area=1&max_total_area=100&sort=tariff&order=asc

Параметры ответа

Параметр	Type	Description
success	boolean	Успешно ли прошёл запрос все проверки
message	string (100)	Сообщение о результате операции
id	string (16)	id объявления
type	enum	Тип объекта: Flat House Parking space Storage room Garage Territory Office
action	enum	Операция с объектом: Sell For rent Exchange Donate
material	enum	Материал стен: not specified Brick Monolithic Panel Wooden Block Tin other
price	int	Стоимость объекта, ₽
period	enum	За какой период оплата: in total per month per day per hour
tariff	enum	Тарифный план: Free Premium
floor	int	Этаж объекта
floors	int	Floors of the object
total_area	float	Общая площадь (м²)
state	enum	Статус объявления на сайте: Active Draft Completed
description	string (255)	Описание объекта.
total	int	Общее количество доступных объявлений
per_page	int	Количество объявлений на странице (default: 25)
current_page	int	Номер текущей страницы (default: 1)
last_page	int	Номер последней страницы

Пример ответа:

200 OK

{
  "success": true,
  "message": "Операция выполнена успешно",
  "data": [
    {
      "id": "5351020320056653",
      "type": "Квартира",
      "action": "Купить",
      "material": "Монолитный",
      "price": 10000000,
      "period": "за всё",
      "tariff": "Премиум",
      "floor": 5,
      "floors": 10,
      "total_area": 50.25,
      "state": "Активное",
      "description": "Пример описания, указывается тут."
    },
    {
      "id": "9564625179668665",
      "type": "Квартира",
      "action": "Купить",
      "material": "Монолитный",
      "price": 10000000,
      "period": "за всё",
      "tariff": "Премиум",
      "floor": 5,
      "floors": 10,
      "total_area": 50.25,
      "state": "Активное",
      "description": "Пример описания, указывается тут."
    }
  ],
  "meta": {
    "total": 2,
    "per_page": 5,
    "current_page": 1,
    "last_page": 1
  }
}

5.2 Creating a new ad

URL: POST https://dvaugla.ru/api/v1/ads

Создает новое объявление о недвижимости. Требует аутентификации и передачи обязательных параметров.

Параметры запроса

Параметр	Type	Обяз.	Description
type	enum	-	Object type: Flat House Parking space Storage room Garage Territory Office
action	enum	-	Операция с объектом: Sell For rent Exchange Donate
apartment	enum	-	Room type: not specified Flat Apartments Комната Доля Доступно только для объектов: Flat
room	enum	-	Rooms: not specified Studio 1 2 3 4 5 6 7 and more Open plan layout Доступно только для объектов: Flat House Office
latitude	float	-	Object coordinates: (Latitude)*
longitude	float	-	Object coordinates: (Longitude)*
country	string (50)	-	Country. Default: Россия.
postal	string (6)	-	Индекс. Default: null*.
city	string (100)	-	Город / Населённый пункт. For example: «г Москва», «деревня Моносеево». Default: null*.
street	string (100)	-	Street. For example: «ул Центральная усадьба». Default: null.
house	string (60)	-	House or plot number. For example: «д 6А». Default: null.
block	string (60)	-	Корпус / Строение. For example: «к 3», «стр 10». Default: null.
flat	string (60)	-	Apartment number. For example: «кв 349». Default: null.
owner	enum	-	Ownership: Owner Агент other
owner_more	string (50)	-	Право собственности (уточнение). Если в параметре `owner` указано: other , то можно уточнить отношение к собственности.
srok	enum	-	Tenure: not specified less than 1 year 1-2 years 2-3 years 3-4 years 4-5 years more than 5 years
ready	date (YYYY-MM-DD)	-	Date of possible occupancy, transfer of ownership. Default: сегодня.
year	date (YYYY)	-	Year of build.
material	enum	-	Wall material: not specified Brick Monolithic Panel Wooden Block Tin other Доступно только для объектов: Flat House Storage room Garage Office
material_more	string (50)	-	Материал стен (уточнение). В случае если в параметре `material` указано значение: other , то в данном параметре можно уточнить материал объекта.
floor	int	-	Floor. Доступно только для объектов: Flat House Parking space Storage room Office
floors	int	-	Floors of the object. Доступно только для объектов: Flat House Parking space Storage room Office
elevator	enum	-	Elevator: not specified absent присутствует
elevator_more	int	-	Лифт (уточнение количества). В случае если в параметре `elevator` указано значение: присутствует , то в данном параметре можно уточнить количество лифтов на объекте.
infra[]	array	-	Infrastructure: Polyclinic School Kindergarten Subway Park Yard without cars Playgrounds Parking Shopping mall Bank Cafe Pharmacy Sports club Shop Creative studio Салоны красоты Водоём Picnic area Охрана Можно передать несколько значений через массив.
comfort[]	array	-	Комплектация: Холодильник Стиральная машина Телевизор Кондиционер Электрочайник Микроволновка Пылесос Утюг и гладильная доска Кофемашина Вентилятор Посудомоечная машина Сушильная машина Плита Интернет Phone Домофон Мебель Можно с животными Можно с детьми Ванна
total_area	float	Yes	Total area (m²)
living_area	float	-	Living area (m²). Доступно только для объектов: Flat House
kitchen_area	float	-	Living area (m²). Доступно только для объектов: Flat House
height	float	-	Ceiling height (m). Доступно только для объектов: Flat House Storage room Garage Office
remont	enum	-	Renovation: not specified without renovation cosmetic Euro-renovation major other Доступно только для объектов: Flat House Storage room Garage Office
remont_more	string (50)	-	Ремонт (уточнение). В случае если в параметре `remont` указано значение: other , то в данном параметре можно уточнить тип ремонта.
bathroom	enum	-	Bathroom: not specified combined separate outside other Доступно только для объектов: Flat House Office
bathroom_more	string (50)	-	Санузел (уточнение). В случае если в параметре `bathroom` указано значение: other , то в данном параметре можно уточнить тип cанузла.
balkon	enum	-	Balcony: not specified absent open glazed loggia french other Доступно только для объектов: Flat House Office
balkon_more	string (50)	-	Санузел (уточнение). В случае если в параметре `balkon` указано значение: other , то в данном параметре можно уточнить тип балкона.
power	enum	-	Energy efficiency class: not specified A++ A+ A B C D E F G Доступно только для объектов: Flat House Office
office_class	enum	-	Office class: not specified A B C D Доступно только для объектов: Office
price	int	Yes	Cost, ₽
period	enum	-	Период оплаты: in total per month per day per hour
commission	enum	-	Agent commission: no commission % of the cost fixed
commission_more	float	-	Комиссия агента (дополнительно). В случае если в параметре `commission` указано значение: % of the cost fixed , то в данном параметре можно уточнить размер комиссии.
by_email	boolean	-	Method of communication: через Email.
contact_email	string	-	Email для связи с Вами. Email автоматически добавится в раздел Контактной информации, если его там не было раньше.
by_phone	boolean	-	Method of communication: по телефону.
contact_phone	string (12)	-	Номер телефона, формат: +79xxxxxxxxx. Телефон автоматически добавится в раздел Контактной информации, если его там не было раньше.
tariff	enum	Yes	Tariff plan: Free Premium
description	string (2000)	-	Description. Длина описания определяется тарифом.
htmlurl	string	-	HTML link to external page of the object (available protocols: https). Доступно для тарифных планов: Premium
photo[]	array	Yes	Photos. Количество определяется тарифом.
state	enum	-	Ad state: Active Draft Completed
days	enum	Yes	На сколько дней размещается: Free: 14 Premium: 30 60 90 120 180 360
bid	float	Yes	Bid. Free: не указывается или указывается: 0.00. Premium: from 1.00 ₽ / 1 дн.

Совет по параметрам адреса:

* Для определения местоположения объекта в запросе должны присутствовать как минимум:
- пара значений: latitude and longitude
- или пара: postal and city.

Если остальные данные адреса не указаны - портал постарается определить их самостоятельно. Переданные параметры адреса являются приоритетными.

Параметры ответа

Если создание объявления было успешно, в заголовок ответа добавляется поле Location с URL новой записи:

Location: https://dvaugla.ru/api/v1/ads/{id}

Параметр	Type	Description
success	boolean	Успешно ли прошёл запрос все проверки
message	string	Сообщение о результате операции
id	string (16)	id объявления
type	string	Object type: Flat House Parking space Storage room Garage Territory Office
action	string	Операция с объектом: Sell For rent Exchange Donate
apartment	string	Room type: not specified Flat Apartments Комната Доля Доступно только для объектов: Flat
room	string	Rooms: not specified Studio 1 2 3 4 5 6 7 and more Open plan layout Доступно только для объектов: Flat House Office
latitude	float	Object coordinates: (Latitude)
longitude	float	Object coordinates: (Longitude)
country	string	Country. Default: Россия.
postal	string	Индекс. Default: null.
city	string	Город / Населённый пункт. For example: «г Москва», «деревня Моносеево». Default: null.
street	string	Street. For example: «ул Центральная усадьба». Default: null.
house	string	House or plot number. For example: «д 6А». Default: null.
block	string	Корпус / Строение. For example: «к 3», «стр 10». Default: null.
flat	string	Apartment number. For example: «кв 349». Default: null.
owner	string	Ownership: Owner Агент other
owner_more	string	Право собственности (уточнение). Если в параметре `owner` указано: other , то можно уточнить отношение к собственности. Default: null.
srok	string	Tenure: not specified less than 1 year 1-2 years 2-3 years 3-4 years 4-5 years more than 5 years
ready	string	Date of possible occupancy, transfer of ownership. Формат: YYYY-MM-DD. Default: сегодня.
year	string	Year of build. Формат: YYYY.
material	string	Wall material: not specified Brick Monolithic Panel Wooden Block Tin other Доступно только для объектов: Flat House Storage room Garage Office
material_more	string	Материал стен (уточнение). Если в параметре `material` указано: other , то можно уточнить материал. Default: null.
floor	string	Floor. Default: null. Доступно только для объектов: Flat House Parking space Storage room Office
floors	string	Floors of the object. Default: null. Доступно только для объектов: Flat House Parking space Storage room Office
elevator	string	Elevator: not specified absent присутствует Доступно только для объектов: Flat House Office
elevator_more	int	Лифт (уточнение количества). Если в параметре `elevator` указано: присутствует , то можно уточнить количество лифтов. Default: null.
infra[]	array	Infrastructure: Polyclinic School Kindergarten Subway Park Yard without cars Playgrounds Parking Shopping mall Bank Cafe Pharmacy Sports club Shop Creative studio Салоны красоты Водоём Picnic area Охрана
comfort[]	array	Комплектация: Холодильник Стиральная машина Телевизор Кондиционер Электрочайник Микроволновка Пылесос Утюг и гладильная доска Кофемашина Вентилятор Посудомоечная машина Сушильная машина Плита Интернет Phone Домофон Мебель Можно с животными Можно с детьми Ванна Доступно только для объектов: Flat House Office Default: [].
total_area	float	Total area (m²)
living_area	float	Living area (m²). Доступно только для объектов: Flat House Default: null.
kitchen_area	float	Kitchen area (m²). Доступно только для объектов: Flat House Default: null.
height	float	Ceiling height (m). Доступно только для объектов: Flat House Storage room Garage Office Default: null.
remont	string	Renovation: not specified without renovation cosmetic Euro-renovation major other Доступно только для объектов: Flat House Storage room Garage Office
remont_more	string	Ремонт (уточнение). Если в параметре `remont` указано: other , то можно уточнить тип ремонта. Default: null.
bathroom	string	Bathroom: not specified combined separate outside other Доступно только для объектов: Flat House Office
bathroom_more	string	Санузел (уточнение). Если в параметре `bathroom` указано: other , то можно уточнить тип санузла. Default: null.
balkon	string	Balcony: not specified absent open glazed loggia french other Доступно только для объектов: Flat House Office
balkon_more	string	Балкон (уточнение). Если в параметре `balkon` указано: other , то можно уточнить тип балкона. Default: null.
power	string	Energy efficiency class: not specified A++ A+ A B C D E F G Доступно только для объектов: Flat House Office
office_class	string	Office class: not specified A B C D Доступно только для объектов: Office
price	int	Cost, ₽
period	string	Период оплаты: in total per month per day per hour
commission	string	Комиссия агента (дополнительно): no commission % of the cost fixed
commission_more	float	Комиссия агента (уточнение). Если в параметре `commission` указано: % of the cost fixed , то можно уточнить размер комиссии. Default: 0.
by_email	boolean	Method of communication: через Email. Default: false.
contact_email	string	Email. Email автоматически добавится в раздел Контактной информации, если его там не было раньше. Default: null.
by_phone	boolean	Method of communication: по телефону. Default: false.
contact_phone	string	Номер телефона, формат: +79xxxxxxxxx. Телефон автоматически добавится в раздел Контактной информации, если его там не было раньше. Default: null.
tariff	string	Tariff plan: Free Premium
description	string	Description. Размер описания определяется в зависимости от выбранного тарифного плана. Возможности тарифных планов описаны на странице: Tariffs. Если поле с описанием длиннее, чем доступно в выбранном тарифном плане, то описание будет обрезано, согласно параметрам тарифного плана. Default: null.
htmlurl	string	HTML link to external page of the object (available protocols: https): доступно для тарифных планов: Premium Default: null.
photo[]	array	Photos. Количество фотографий определяется выбранным тарифным планом. Возможности тарифных планов описаны на странице: Tariffs. Фотографии сверх того, что доступно в выбранном тарифном плане — не сохраняются.
state	string	Ad state: Active Draft Completed
days	float	На сколько дней размещается объявление: Free: доступны значения (дни): 14 Premium: доступны значения (дни): 30 60 90 120 180 360
bid	float	Размер ставки. Default: 0.
cost	float	Итоговая стоимость размещения объявления. Default: 0.
order_url	string	Ссылка для оплаты объявления на выбранном тарифном плане.
order_expired	datetime	Дата истечения срока оплаты ордера. По умолчанию: 24 часа с момента создания объявления. После истечения срока надо создать новую ссылку для оплаты.
created_at	datetime	Дата создания объявления.

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

Пример №1 (только обязательные параметры)

POST https://dvaugla.ru/api/v1/ads
{
  "latitude": 55.836773,
  "longitude": 37.491909,
  "total_area": 50.25,
  "price": 10000000,
  "tariff": "Премиум",
  "photo[]": "photofile.png",
  "days": "60",
  "bid": 17.10
}

Пример №2 (с необязательными параметрами)

POST https://dvaugla.ru/api/v1/ads
{
  "type": "Квартира",
  "action": "Продать",
  "apartment": "Квартира",
  "room": "1",
  "latitude": 55.836773,
  "longitude": 37.491909,
  "country": "Россия",
  "postal": "125212",
  "city": "г Москва",
  "street": "ул Адмирала Макарова",
  "house": "д 6А",
  "block": "к 1",
  "flat": "кв 349",
  "owner": "другой",
  "owner_more": "Сосед",
  "srok": "меньше 1 года",
  "ready": "2025-06-01",
  "year": "2020",
  "material": "другой",
  "material_more": "Сено",
  "floor": "5",
  "floors": "10",
  "elevator": "присутствует",
  "elevator_more": "4",
  "infra[]": "Поликлиника",
  "infra[]": "Школа",
  "comfort[]": "Телевизор",
  "comfort[]": "Плита",
  "total_area": 50.25,
  "living_area": "30.5",
  "kitchen_area": "10.47",
  "height": "3",
  "remont": "другой",
  "remont_more": "так себе",
  "bathroom": "другой",
  "bathroom_more": "отсутствует",
  "balkon": "другой",
  "balkon_more": "переделан в комнату",
  "power": "A",
  "price": 10000000,
  "period": "за всё",
  "commission": "% от стоимости",
  "commission_more": "5",
  "by_email": "1",
  "contact_email": "test@yandex.ru",
  "by_phone": "1",
  "contact_phone": "+79688668860",
  "tariff": "Премиум",
  "description": "Пример описания, указывается тут.",
  "htmlurl": "https://dvaugla.ru",
  "photo[]": "foto1.png",
  "photo[]": "foto2.jpg",
  "state": "Активное",
  "days": "60",
  "bid": 18
}

Sample answers

201 Created :

{
  "success": true,
  "message": "Операция выполнена успешно",
  "data": {
    "id": "8426893080997327",
    "type": "Квартира",
    "action": "Продать",
    "apartment": "не указано",
    "room": "не указано",
    "latitude": 55.836773,
    "longitude": 37.491909,
    "country": "Россия",
    "postal": "125212",
    "city": "г Москва",
    "street": "ул Адмирала Макарова",
    "house": "д 6А",
    "block": "к 1",
    "flat": null,
    "owner": "Собственник",
    "owner_more": null,
    "srok": "не указано",
    "ready": "2025-06-16",
    "year": null,
    "material": "не указано",
    "material_more": null,
    "floor": null,
    "floors": null,
    "elevator": "не указано",
    "elevator_more": null,
    "infra": [],
    "comfort": [],
    "total_area": 50.25,
    "living_area": null,
    "kitchen_area": null,
    "height": null,
    "remont": "не указано",
    "remont_more": null,
    "bathroom": "не указано",
    "bathroom_more": null,
    "balkon": "не указано",
    "balkon_more": null,
    "power": "не указано",
    "office_class": null,
    "price": 10000000,
    "period": "за всё",
    "commission": "нет комиссии",
    "commission_more": null,
    "by_email": false,
    "contact_email": null,
    "by_phone": false,
    "contact_phone": null,
    "tariff": "Премиум",
    "description": null,
    "htmlurl": null,
    "photo": [
      "ad-images/6854157d72a191160048371456165.png"
    ],
    "state": "Активное",
    "days": 60,
    "bid": 17.10,
    "cost": 1026,
    "order_url": "https://yoomoney.ru/checkout/payments/v2/contract?orderId=...",
    "order_expired": "2025-06-18T16:31:49+03:00",
    "created_at": "2025-06-17T16:31:49+03:00"
  }
}

5.3 View Ad

URL: GET https://dvaugla.ru/api/v1/ads/{id}

Возвращает информацию по указанному объекту.

Параметры запроса

Параметр	Type	Description
id	string (16)	id объявления
format	enum	Формат вывода данных. Полный или укороченный формат. short full
with	enum	Дополнительная информация по объекту: full — вся доступная информация type action apartment room latitude longitude country postal city street house block flat owner srok material elevator infra comfort remont bathroom balkon power office_class period commission contact_email contact_phone tariff description htmlurl photo state user

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

Базовый запрос:

https://dvaugla.ru/api/v1/ads/9373075910006562

С параметром format=short:

https://dvaugla.ru/api/v1/ads/9373075910006562?format=short

С параметрами format=full и with:

https://dvaugla.ru/api/v1/ads/9373075910006562?format=full&with=photo,user

Информация по параметрам статусам объявлений:

Если запрос поступил от автора объявления, то возвращается объявление с любым статусом (поле: state ) в противном случае возвращаются объявления только со статусами:

Active Completed

Параметры ответа

Параметр	Type	Description
success	boolean	Успешно ли прошёл запрос все проверки
message	string	Сообщение о результате операции
id	string (16)	id объявления
type	string	Object type: Flat House Parking space Storage room Garage Territory Office
action	string	Операция с объектом: Sell For rent Exchange Donate
apartment	string	Room type: not specified Flat Apartments Комната Доля Доступно только для объектов: Flat
room	string	Rooms: not specified Studio 1 2 3 4 5 6 7 and more Open plan layout Доступно только для объектов: Flat House Office
latitude	float	Object coordinates: (Latitude)
longitude	float	Object coordinates: (Longitude)
country	string	Country. Default: Россия.
postal	string	Индекс. Default: null.
city	string	Город / Населённый пункт. For example: «г Москва», «деревня Моносеево». Default: null.
street	string	Street. For example: «ул Центральная усадьба». Default: null.
house	string	House or plot number. For example: «д 6А». Default: null.
block	string	Корпус / Строение. For example: «к 3», «стр 10». Default: null.
flat	string	Apartment number. For example: «кв 349». Default: null.
owner	string	Ownership: Owner Агент other
owner_more	string	Право собственности (уточнение). Если в параметре `owner` указано: other , то можно уточнить отношение к собственности. Default: null.
srok	string	Tenure: not specified less than 1 year 1-2 years 2-3 years 3-4 years 4-5 years more than 5 years
ready	string	Date of possible occupancy, transfer of ownership. Default: сегодня.
year	string	Year of build.
material	string	Wall material: not specified Brick Monolithic Panel Wooden Block Tin other Доступно только для объектов: Flat House Storage room Garage Office
material_more	string	Материал стен (уточнение). Если в параметре `material` указано: other , то можно уточнить материал. Default: null.
floor	string	Floor. Default: null. Доступно только для объектов: Flat House Parking space Storage room Office
floors	string	Floors of the object. Default: null. Доступно только для объектов: Flat House Parking space Storage room Office
elevator	string	Elevator: not specified absent присутствует Доступно только для объектов: Flat House Office
elevator_more	int	Лифт (уточнение количества). Если в параметре `elevator` указано: присутствует , то можно уточнить количество лифтов. Default: null.
infra[]	array	Infrastructure: Polyclinic School Kindergarten Subway Park Yard without cars Playgrounds Parking Shopping mall Bank Cafe Pharmacy Sports club Shop Creative studio Салоны красоты Водоём Picnic area Охрана
comfort[]	array	Комплектация: Холодильник Стиральная машина Телевизор Кондиционер Электрочайник Микроволновка Пылесос Утюг и гладильная доска Кофемашина Вентилятор Посудомоечная машина Сушильная машина Плита Интернет Phone Домофон Мебель Можно с животными Можно с детьми Ванна
total_area	float	Total area (m²)
living_area	string	Living area (m²). Доступно только для объектов: Flat House Default: null.
kitchen_area	string	Kitchen area (m²). Доступно только для объектов: Flat House Default: null.
height	string	Ceiling height (m). Доступно только для объектов: Flat House Storage room Garage Office Default: null.
remont	string	Renovation: not specified without renovation cosmetic Euro-renovation major other Доступно только для объектов: Flat House Storage room Garage Office
remont_more	string	Ремонт (уточнение). Если в параметре `remont` указано: other , то можно уточнить тип ремонта. Default: null.
bathroom	string	Bathroom: not specified combined separate outside other Доступно только для объектов: Flat House Office
bathroom_more	string	Санузел (уточнение). Если в параметре `bathroom` указано: other , то можно уточнить тип санузла. Default: null.
balkon	string	Balcony: not specified absent open glazed loggia french other Доступно только для объектов: Flat House Office
balkon_more	string	Балкон (уточнение). Если в параметре `balkon` указано: other , то можно уточнить тип балкона. Default: null.
power	string	Energy efficiency class: not specified A++ A+ A B C D E F G Доступно только для объектов: Flat House Office
office_class	string	Office class: not specified A B C D Доступно только для объектов: Office
price	int	Cost, ₽
period	string	Период оплаты: in total per month per day per hour
commission	string	Комиссия агента (дополнительно): no commission % of the cost fixed
commission_more	float	Комиссия агента (уточнение). Если в параметре `commission` указано: % of the cost fixed , то можно уточнить размер комиссии. Default: 0.
by_email	boolean	Method of communication: через Email. Default: false.
contact_email	string	Email. Email автоматически добавится в раздел Контактной информации, если его там не было раньше. Default: null.
by_phone	boolean	Method of communication: по телефону. Default: false.
contact_phone	string	Номер телефона, формат: +79xxxxxxxxx. Телефон автоматически добавится в раздел Контактной информации, если его там не было раньше. Default: null.
tariff	string	Tariff plan: Free Premium
description	string	Description. Размер описания определяется в зависимости от выбранного тарифного плана. Возможности тарифных планов описаны на странице: Tariffs. Если поле с описанием длиннее, чем доступно в выбранном тарифном плане, то описание будет обрезано, согласно параметрам тарифного плана. Default: null.
htmlurl	string	HTML link to external page of the object (available protocols: https): доступно для тарифных планов: Premium Default: null.
photo[]	array	Photos. Количество фотографий определяется выбранным тарифным планом. Возможности тарифных планов описаны на странице: Tariffs. Фотографии сверх того, что доступно в выбранном тарифном плане — не сохраняются.
state	string	Ad state: Active Draft Completed
days	float	На сколько дней размещается объявление: Free: доступны значения (дни): 14 Premium: доступны значения (дни): 30 60 90 120 180 360
bid	float	Размер ставки. Default: 0.
cost	float	Итоговая стоимость размещения объявления. Default: 0.
order_url	string	Ссылка для оплаты объявления на выбранном тарифном плане.
order_expired	datetime	Дата истечения срока оплаты ордера. По умолчанию: 24 часа с момента создания объявления. После истечения срока надо создать новую ссылку для оплаты.
rating	float	Рейтинг по 5-бальной системе на основании отзывов. Точность - 2 знака после запятой.
created_at	datetime	Дата создания объявления.
stoped_at	datetime	Дата завершения показа объявления.

Пример ответа:

200 OK

{
  "success": true,
  "message": "Операция выполнена успешно",
  "data": {
    "id": "9373075910006562",
    "type": "Квартира",
    "action": "Продать",
    "apartment": "Квартира",
    "room": "1",
    "latitude": "55.836773000",
    "longitude": "37.491909000",
    "country": "Россия",
    "postal": "125212",
    "city": "г Москва",
    "street": "ул Адмирала Макарова",
    "house": "д 6А",
    "block": "к 1",
    "flat": "кв 349",
    "owner": "другой",
    "owner_more": "Сосед",
    "srok": "меньше 1 года",
    "ready": "2025-06-01",
    "year": "2020",
    "material": "другой",
    "material_more": "Сено",
    "floor": 5,
    "floors": 10,
    "elevator": "присутствует",
    "elevator_more": 4,
    "infra": ["Школа", "Поликлиника"],
    "comfort": ["Телевизор", "Плита"],
    "total_area": 50.25,
    "living_area": "30.50",
    "kitchen_area": "10.47",
    "height": "3.00",
    "remont": "другой",
    "remont_more": "так себе",
    "bathroom": "другой",
    "bathroom_more": "отсутствует",
    "balkon": "другой",
    "balkon_more": "переделан в комнату",
    "power": "A",
    "office_class": null,
    "price": 10000000,
    "period": "за всё",
    "commission_more": 5,
    "commission": "% от стоимости",
    "by_email": true,
    "contact_email": "test@yandex.ru",
    "by_phone": true,
    "contact_phone": "+79688668860",
    "tariff": "Премиум",
    "description": "Пример описания, указывается тут.",
    "htmlurl": "https://dvaugla.ru",
    "photo": ["http://dvaugla.ru/storage/ad-images/..."],
    "state": "Активное",
    "rating": 0,
    "created_at": "2025-07-06T20:52:04+03:00",
    "stoped_at": "2025-08-06T20:52:04+03:00",
    "user": {
      "id": "7247191241678337",
      "name": "Алексей",
      "rating": 0,
      "rating_count": 0
    }
  }
}

5.4 Удаление объявления

URL: DELETE https://dvaugla.ru/api/v1/ads/{id}

Удаление объявления происходит через DELETE-запрос к соответствующему ресурсу. Доступно только автору.

Особенности:

Удаление доступно только автору объявления.
После удаления объект перестаёт отображаться в поиске.
Удалённые объявления хранятся 30 дней для возможного восстановления.
Для восстановления используйте PUT с параметром state=recovery

Параметры запроса

Параметр	Type	Description
id	string (16)	Уникальный идентификатор объявления

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

DELETE https://dvaugla.ru/api/v1/ads/9373075910006562

Параметры ответа

Параметр	Type	Description
success	boolean	Статус выполнения запроса
message	string	Сообщение о результате операции
data	object	Данные удалённого объекта (укороченный формат)
id	string (16)	ID удалённого объявления
deleted_at	datetime	Дата и время удаления

Пример ответа:

200 OK

{
  "success": true,
  "message": "Операция выполнена успешно",
  "data": {
    "id": "9373075910006562",
    "deleted_at": "2025-07-06T20:52:04+03:00"
  }
}