{ "info": { "name": "Rentix CRM API", "description": "Полная коллекция API для интеграции Rentix CRM.\n\nАвтоматизируйте публикацию объявлений, синхронизацию агентов и управление медиафайлами.\n\n**Начало работы:**\n- Перейдите на вкладку `Variables`\n- Укажите ваш API ключ в переменной `apiKey`\n- (Опционально) Для работы с production измените `baseUrl` на `https://crm.rentix.md/api`\n\nДокументация: https://crm.rentix.md\n\n## Типы и перечисления\n\n### Объявление\n- **announcementType**: rent, sale\n- **announcementStatus**: draft, active, pending_active, publish_failed, expired, hidden, removed, completed, blocked\n- **announcementCurrency**: EUR, USD, MDL\n- **announcementBargain**: no, yes\n\n### Для аренды\n- **announcementPayPeriod**: monthly, daily, hourly, yearly\n- **announcementPrepayment**: first-and-last-month, no-prepayment, months-3, months-6, custom-amount\n- **announcementRentDeposit**: months-1, months-3, custom-amount\n\n### Типы недвижимости\n- **propertyType**: residential, commercial, parking\n- **propertySecondaryType**:\n - rent/residential: apartment, house, room, other\n - rent/commercial: office, trade, warehouse, free-purpose, production, business, commercial-land, legal-address, other\n - rent/parking: underground-parking, open-parking, garage, covered-parking, other\n - sale/residential: apartment, house, room, residential-land, other\n - sale/commercial: office, trade, warehouse, free-purpose, production, business, commercial-land, legal-address, other\n - sale/parking: underground-parking, open-parking, garage, covered-parking, other\n\n### Поля недвижимости\n- **propertyQuantitySize**: apartment-studio, custom-value\n- **propertyVisualState**: classic-renovation, euro-renovation, design-renovation, requires-renovation, white-finish, rough-finish\n- **propertyHousingMarket**: secondary, new-build\n- **propertyBuildingMaterial**: brick, mixed, cotilet, monolithic, concrete, block, wood, panel, aerated-concrete\n- **propertyLayout**: 102, 135, 143, brezhnevka, varnitskaia, gostinka, custom, small-family, moldovan-series, ground-level, rubashka, stalinka, khrushchyovka, cheska\n- **propertyParkingSpace**: underground, open, garage, covered\n\n### Атрибуты (propertyAttributes)\n- **Правила**: animals-allowed, can-smoke, kids-allowed, parties-allowed\n- **Удобства**: autonomous-heating, heated-floors, panoramic-windows, conditioner, tumble-dryer, dishwasher, wifi, open-plan-kitchen, balcony, terrace, work-space, kitchen, toilet, walk-in-shower, bathtub, bidet, tv, oven, pool, jacuzzi, gas, water, sewerage, video-surveillance, security, intercom, fireplace, sauna, garden, elevator, gym, playground, bbq-area, furnished", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "version": "1.0.0" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://crm.staging.rentix.md/api", "type": "string" }, { "key": "apiKey", "value": "your-api-key-here", "type": "string" } ], "item": [ { "name": "Агентство", "description": "Получение информации об агентстве и лимитах использования.", "item": [ { "name": "Получить информацию об агентстве", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/agency", "host": [ "{{baseUrl}}" ], "path": [ "v1", "agency" ] }, "description": "Возвращает название агентства, ID и текущие лимиты использования." }, "response": [] } ] }, { "name": "Объявления", "description": "Создание, обновление, получение и управление объявлениями недвижимости. Поддержка upsert, bulk-операций и привязки external ID.", "item": [ { "name": "Создать или обновить объявление", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings" ] }, "description": "Создание/обновление объявления. Если externalId новый — создаёт, если существует — обновляет. При обновлении отправляйте только изменённые поля.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"apt-001\",\n \"announcementStatus\": \"active\",\n \"announcementType\": \"rent\",\n \"propertyType\": \"residential\",\n \"propertySecondaryType\": \"apartment\",\n \"announcementValue\": 500,\n \"announcementCurrency\": \"EUR\",\n \"announcementPayPeriod\": \"monthly\",\n \"propertyArea\": 65,\n \"propertyFloorNumber\": 3,\n \"propertyFloorsTotal\": 9,\n \"propertyQuantitySize\": \"custom-value\",\n \"propertyQuantitySizeValue\": 3,\n \"propertyHousingMarket\": \"new-build\",\n \"propertyVisualState\": \"euro-renovation\",\n \"propertyAddress\": \"Chișinău, str. Columna 81/1\",\n \"announcementDescription\": \"Уютная 3-комнатная квартира с тёплыми полами и автономным отоплением.\",\n \"files\": [\n {\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Гостиная\",\n \"externalFileId\": \"apt-001-photo-1\"\n },\n {\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Спальня\",\n \"externalFileId\": \"apt-001-photo-2\"\n },\n {\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Кухня\",\n \"externalFileId\": \"apt-001-photo-3\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Валидировать объявление", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/validate", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", "validate" ] }, "description": "Проверка данных объявления без создания. Полезно для валидации форм в CRM.", "body": { "mode": "raw", "raw": "{\n \"announcementType\": \"rent\",\n \"propertyType\": \"residential\",\n \"propertySecondaryType\": \"apartment\",\n \"announcementValue\": 500,\n \"announcementCurrency\": \"EUR\",\n \"announcementDescription\": \"Уютная 3-комнатная квартира с тёплыми полами и автономным отоплением.\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Массовые операции", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", "bulk" ] }, "description": "Обработка до 100 операций с объявлениями в одном запросе. Поддержка upsert, link, unlink, delete и validate.", "body": { "mode": "raw", "raw": "{\n \"operations\": [\n {\n \"op\": \"upsert\",\n \"externalId\": \"apt-001\",\n \"announcementType\": \"rent\",\n \"propertyType\": \"residential\",\n \"propertySecondaryType\": \"apartment\",\n \"announcementValue\": 500,\n \"announcementCurrency\": \"EUR\"\n },\n {\n \"op\": \"link\",\n \"id\": 42,\n \"externalId\": \"apt-001\"\n },\n {\n \"op\": \"delete\",\n \"externalId\": \"apt-002\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Список объявлений", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings" ], "query": [ { "key": "status", "value": "active", "description": "Фильтр по статусу (draft, active, hidden, completed, pending_active)", "disabled": true }, { "key": "userId", "value": "1", "description": "Фильтр по ID пользователя Rentix", "disabled": true }, { "key": "externalUserId", "value": "agent-001", "description": "Фильтр по external ID пользователя", "disabled": true }, { "key": "syncedAfter", "value": "2025-01-01T00:00:00Z", "description": "Только объявления, синхронизированные после этой даты", "disabled": true }, { "key": "page", "value": "1", "description": "Номер страницы (по умолчанию 1)", "disabled": true }, { "key": "limit", "value": "20", "description": "Элементов на странице, макс 100 (по умолчанию 20)", "disabled": true } ] }, "description": "Получить постраничный список объявлений с фильтрами." }, "response": [] }, { "name": "Получить объявление по ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", ":id" ] }, "description": "Получить объявление по внутреннему ID Rentix." }, "response": [] }, { "name": "Получить объявление по External ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", "external", ":externalId" ] }, "description": "Получить объявление по вашему external ID из CRM." }, "response": [] }, { "name": "Привязать External ID", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", ":id", "link" ] }, "description": "Привязать external ID из CRM к существующему объявлению Rentix.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"apt-001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Отвязать External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", ":id", "link" ] }, "description": "Удалить привязку external ID от объявления." }, "response": [] } ] }, { "name": "Пользователи", "description": "Создание, обновление и управление профилями агентов. Поддержка upsert и привязки external ID.", "item": [ { "name": "Создать или обновить пользователя", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users" ] }, "description": "Создание/обновление профиля агента. Идентификация по externalId или id.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"agent-001\",\n \"name\": \"Иван Петров\",\n \"description\": \"Опытный агент по недвижимости. Работаю с жилой и коммерческой недвижимостью.\",\n \"instagram\": \"https://instagram.com/ivan.petrov\",\n \"settings\": {\n \"contact_phone\": true,\n \"contact_whatsapp\": true,\n \"contact_telegram\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Массовые операции", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", "bulk" ] }, "description": "Обработка до 100 операций с пользователями в одном запросе.", "body": { "mode": "raw", "raw": "{\n \"operations\": [\n {\n \"op\": \"upsert\",\n \"externalId\": \"agent-001\",\n \"name\": \"Иван Петров\",\n \"settings\": {\n \"contact_whatsapp\": true\n }\n },\n {\n \"op\": \"upsert\",\n \"externalId\": \"agent-002\",\n \"name\": \"Мария Иванова\",\n \"settings\": {\n \"contact_telegram\": true\n }\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Список пользователей", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users" ] }, "description": "Получить список всех агентов вашего агентства." }, "response": [] }, { "name": "Получить пользователя по ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", ":id" ] }, "description": "Получить агента по внутреннему ID Rentix." }, "response": [] }, { "name": "Получить пользователя по External ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", "external", ":externalId" ] }, "description": "Получить агента по вашему external ID из CRM." }, "response": [] }, { "name": "Привязать External ID", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", ":id", "link" ] }, "description": "Привязать external ID из CRM к существующему пользователю Rentix.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"agent-001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Отвязать External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", ":id", "link" ] }, "description": "Удалить привязку external ID от пользователя." }, "response": [] } ] }, { "name": "Медиа", "description": "Загрузка, управление и привязка медиафайлов. Поддержка импорта по URL, подписанных URL и bulk-операций.", "item": [ { "name": "Запросить URL для загрузки", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/request-upload-url", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "request-upload-url" ] }, "description": "Получить подписанные URL для прямой загрузки файлов. URL действительны 30 минут.", "body": { "mode": "raw", "raw": "{\n \"files\": [\n {\n \"fileName\": \"living-room.jpg\",\n \"size\": 245000,\n \"contentType\": \"image/jpeg\",\n \"externalId\": \"apt-001-photo-1\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Подтвердить загрузку", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/confirm-upload", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "confirm-upload" ] }, "description": "Подтвердить, что файл был загружен по подписанному URL.", "body": { "mode": "raw", "raw": "{\n \"generatedFileName\": \"abc123_living-room.jpg\",\n \"uuid\": \"abc123\",\n \"externalId\": \"apt-001-photo-1\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Загрузить по URL", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/upload-from-url", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "upload-from-url" ] }, "description": "Импорт медиафайла по публичному URL. Система автоматически загружает и оптимизирует файл.", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Гостиная\",\n \"externalId\": \"apt-001-photo-1\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Массовые операции", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "bulk" ] }, "description": "Обработка до 100 операций с медиа в одном запросе. Поддержка upload-from-url, confirm-upload, link, unlink и delete.", "body": { "mode": "raw", "raw": "{\n \"operations\": [\n {\n \"op\": \"upload-from-url\",\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Гостиная\",\n \"externalId\": \"apt-001-photo-1\"\n },\n {\n \"op\": \"upload-from-url\",\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Спальня\",\n \"externalId\": \"apt-001-photo-2\"\n },\n {\n \"op\": \"link\",\n \"mediaId\": 123,\n \"externalId\": \"old-photo-linked\"\n },\n {\n \"op\": \"delete\",\n \"externalId\": \"old-photo-to-remove\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Получить медиа", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId" ] }, "description": "Получить медиафайл по внутреннему ID Rentix." }, "response": [] }, { "name": "Получить медиа по External ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "external", ":externalId" ] }, "description": "Получить медиафайл по вашему external ID из CRM." }, "response": [] }, { "name": "Удалить медиа", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId" ] }, "description": "Удалить медиафайл по внутреннему ID Rentix." }, "response": [] }, { "name": "Удалить медиа по External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "external", ":externalId" ] }, "description": "Удалить медиафайл по вашему external ID из CRM." }, "response": [] }, { "name": "Привязать External ID", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId", "link" ] }, "description": "Привязать external ID из CRM к существующему медиафайлу.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"apt-001-photo-1\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Отвязать External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId", "link" ] }, "description": "Удалить привязку external ID от медиафайла." }, "response": [] } ] }, { "name": "Справочники", "description": "Доступ к справочным данным: схемы полей, локации и валюты.", "item": [ { "name": "Получить базовую схему", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/reference/schema/base", "host": [ "{{baseUrl}}" ], "path": [ "v1", "reference", "schema", "base" ] }, "description": "Получить базовую схему полей. Возвращает типы объявлений, категории недвижимости, поля формы и ограничения." }, "response": [] }, { "name": "Получить контекстную схему", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/reference/schema", "host": [ "{{baseUrl}}" ], "path": [ "v1", "reference", "schema" ], "query": [ { "key": "announcementType", "value": "rent", "description": "rent или sale" }, { "key": "propertyType", "value": "residential", "description": "residential, commercial или parking" }, { "key": "propertySecondaryType", "value": "apartment", "description": "Конкретный подтип недвижимости" } ] }, "description": "Получить контекстную схему полей для конкретной комбинации типа недвижимости. Все 3 параметра обязательны." }, "response": [] }, { "name": "Получить валюты", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/reference/currencies", "host": [ "{{baseUrl}}" ], "path": [ "v1", "reference", "currencies" ] }, "description": "Получить поддерживаемые валюты и текущие курсы обмена." }, "response": [] } ] }, { "name": "Задачи", "description": "Отслеживание статуса асинхронных фоновых задач (обработка фото, публикация и т.д.).", "item": [ { "name": "Получить статус задачи", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/job/status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "job", "status" ], "query": [ { "key": "id", "value": "789", "description": "ID задачи, полученный из операций с объявлениями/медиа" } ] }, "description": "Проверить статус асинхронной задачи по её ID." }, "response": [] } ] } ] }