Объявления
Обзор объявлений
Типы недвижимости, статусы и жизненный цикл объявлений
Объявления — основной ресурс API. Через него вы публикуете недвижимость на Rentix: квартиры, дома, офисы, парковки.
Что можно делать
| Действие | Описание |
|---|---|
| Создать объявление | Добавить новый объект недвижимости |
| Обновить объявление | Изменить цену, описание, характеристики |
| Опубликовать | Сделать объявление видимым на сайте |
| Скрыть | Временно убрать с сайта |
| Массовые операции | Обработать до 100 объявлений за запрос |
Типы объявлений
Каждое объявление имеет тип сделки и тип недвижимости:
Тип сделки
| Значение | Описание |
|---|---|
rent | Аренда (посуточно, помесячно) |
sale | Продажа |
Типы недвижимости
| Тип | Подтипы | Примеры |
|---|---|---|
residential | apartment, house, room, residential-land, other | Квартиры, дома, комнаты |
commercial | office, trade, warehouse, production, business, commercial-land, other | Офисы, магазины, склады |
parking | underground-parking, open-parking, garage, covered-parking, other | Гаражи, парковочные места |
Статусы объявлений
Статус определяет, видно ли объявление на сайте и что с ним можно делать.
| Статус | Описание | Видимость | Что делать |
|---|---|---|---|
draft | Черновик | Только вы | Добавить фото, установить active |
pending_active | На обработке | Только вы | Дождаться завершения |
active | Опубликовано | Все | Объявление на сайте |
hidden | Скрыто вами | Только вы | Установить active для возврата |
expired | Истёк срок | Только вы | Установить active для продления |
completed | Сделка закрыта | Все | Можно вернуть в active или hidden |
publish_failed | Ошибка | Только вы | Исправить и повторить |
blocked | Заблокировано | Только вы | Связаться с поддержкой |
Полная валидация обязательных полей выполняется только для публичных статусов (
active, expired, completed). Черновики и скрытые объявления можно сохранять с неполными данными.Жизненный цикл
┌─────────────┐
│ draft │ ← Создание
└──────┬──────┘
│ announcementStatus: "active"
▼
┌─────────────┐
│pending_active│ ← Обработка (фото, перевод)
└──────┬──────┘
┌────────┴────────┐
▼ ▼
┌─────────────┐ ┌─────────────┐
│ active │ │publish_failed│
└──────┬──────┘ └─────────────┘
┌──────┬──────┼──────┐
▼ ▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐
│ hidden │ │completed│ │expired │ ← Через 30 дней
└────────┘ └────────┘ └────────┘
Типичные переходы
| Из | В | Как |
|---|---|---|
draft | pending_active | Установить announcementStatus: "active" + минимум 3 фото |
pending_active | active | Автоматически после обработки |
active | hidden | Установить announcementStatus: "hidden" |
hidden | active | Установить announcementStatus: "active" |
active | expired | Автоматически через 30 дней |
expired | pending_active | Установить announcementStatus: "active" |
active | completed | Установить announcementStatus: "completed" |
completed | active | Установить announcementStatus: "active" |
Срок жизни
Объявление активно 30 дней с момента публикации. После этого:
- Статус автоматически меняется на
expired - Объявление исчезает с сайта
- Данные сохраняются — можно продлить
Чтобы продлить объявление, установите announcementStatus: "active" — система обработает его заново и опубликует на следующие 30 дней.
Ограничения
| Параметр | Значение |
|---|---|
| Фото для публикации | 3–20 штук |
| Длина описания | 40–2000 символов |
| Bulk-операции | До 100 объявлений за запрос |
API Endpoints
| Метод | Путь | Описание |
|---|---|---|
PUT | /listings | Создать или обновить |
POST | /listings/validate | Проверить без сохранения |
POST | /listings/bulk | Массовые операции |
GET | /listings | Список объявлений |
GET | /listings/:id | Получить по ID |
GET | /listings/external/:externalId | Получить по external ID |
POST | /listings/:id/link | Привязать external ID |
DELETE | /listings/:id/link | Отвязать external ID |
Следующие шаги
- Создать объявление — полный пример с описанием всех полей
- Загрузить фотографии — способы загрузки медиафайлов
- Bulk-операции — синхронизация нескольких объявлений