{"openapi": "3.1.0", "info": {"title": "Фриди: шлюз для ИИ-агентов (ФРИДОМ 360)", "version": "0.1.0", "description": "Подбор новостроек, карточки объектов, сроки сдачи и вопросы Фриди для ИИ-ассистентов. Публичный уровень без ключа: лимиты, журнал, без персональных данных и закрытых лотов. Расширенный уровень по ключу. Персональные данные не принимаются: клиента передают ссылкой (handoff_link)."}, "servers": [{"url": "https://portal.freedom360.ru"}], "paths": {"/api/agent/v1/tools/search_properties": {"post": {"operationId": "search_properties", "summary": "Подбор новостроек по потребностям", "description": "Подбирает квартиры в новостройках Москвы и области под потребности клиента (бюджет, комнаты, район или метро, срок, ипотека) и объясняет, почему подошёл каждый вариант; у каждого варианта есть паспорт качества данных. Не принимает персональные данные, не показывает закрытые предложения и не бронирует. Значения кладите в СТРУКТУРНЫЕ поля needs, а не в text: район, метро или название ЖК - needs.places (список строк), бюджет - needs.budget_max / budget_min числом в рублях («до 30 млн» = 30000000), комнаты - needs.rooms (0 - студия). Пример: {\"needs\": {\"rooms\": 2, \"budget_max\": 30000000, \"places\": [\"Хамовники\"]}}. ЖК по названию: {\"needs\": {\"places\": [\"Фили Град\"]}}, он вернётся в items с matched_by_name. Идентификатор объекта для других инструментов - поле property_id элемента items («lot:123» или «complex:45»).", "tags": ["tools"], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["needs"], "properties": {"needs": {"type": "object", "description": "Потребности клиента без персональных данных (профиль needs/1). Каждое значение кладите в СВОЁ поле: район, метро или название ЖК - places (список строк), бюджет - budget_max/budget_min числом в рублях («до 30 млн» = 30000000), комнаты - rooms. Свободный text - только для остального; из него сервер лишь пробует достать простой бюджет и комнаты. Незнакомые поля игнорируются.", "examples": [{"rooms": 2, "budget_max": 30000000, "places": ["Хамовники"]}, {"budget_max": 15000000, "rooms": 1, "places": ["Москва"]}, {"places": ["Фили Град"]}], "properties": {"budget_max": {"type": "integer", "minimum": 0, "maximum": 10000000000, "description": "Бюджет до, числом в рублях: «до 30 млн» = 30000000."}, "budget_min": {"type": "integer", "minimum": 0, "maximum": 10000000000, "description": "Бюджет от, числом в рублях: «от 10 млн» = 10000000."}, "rooms": {"type": "integer", "minimum": 0, "maximum": 10, "description": "Число комнат: 2 для «двушки» и «2-комнатной»; 0 - студия."}, "rooms_gte": {"type": "boolean", "description": "true: «столько комнат и больше»."}, "area_min": {"type": "integer", "minimum": 1, "maximum": 1000, "description": "Площадь от, м2."}, "area_max": {"type": "integer", "minimum": 1, "maximum": 1000, "description": "Площадь до, м2."}, "places": {"type": "array", "maxItems": 5, "items": {"type": "string", "maxLength": 80}, "description": "Район, станция метро или название ЖК - СПИСОК строк (до 5), например [\"Хамовники\"], [\"Сокол\"], [\"Фили Град\"]. Сюда, а не в text. Название ЖК находит этот ЖК в items. Без точного адреса."}, "metro_max_min": {"type": "integer", "minimum": 1, "maximum": 120, "description": "До метро не дольше, минут."}, "ready_by_year": {"type": "integer", "minimum": 2024, "maximum": 2040, "description": "Нужна квартира не позже этого года."}, "ready_only": {"type": "boolean", "description": "true: только сданные дома."}, "mortgage": {"type": "boolean", "description": "true: покупка с ипотекой (бюджет сверяется с ипотечной ценой)."}, "purpose": {"type": "string", "enum": ["live", "invest"], "description": "Цель: жить или вложение."}, "decoration": {"type": "array", "maxItems": 4, "items": {"type": "string", "enum": ["none", "pre_fine", "fine", "turnkey"]}, "description": "Отделка: none, pre_fine, fine, turnkey."}, "text": {"type": "string", "maxLength": 500, "description": "Остальные пожелания своими словами (этаж, вид, школа рядом). Район, бюджет и комнаты - в свои поля, не сюда. Без имени, телефона, почты и точного адреса."}}}, "limit": {"type": "integer", "minimum": 1, "maximum": 6, "description": "Сколько вариантов вернуть (публичный уровень до 3, партнёрский до 6)."}}, "examples": [{"needs": {"rooms": 2, "budget_max": 30000000, "places": ["Хамовники"]}}, {"needs": {"places": ["Фили Град"]}}]}}}}, "responses": {"200": {"description": "Результат", "content": {"application/json": {"schema": {"type": "object", "description": "Единый формат ответа: данные, качество, источник, дата, уровень раскрытия.", "properties": {"data": {"type": "object"}, "quality": {"type": "object", "description": "Паспорт качества данных: общий балл 0-100, класс high/mid/low, причины на русском, оговорка ниже порога.", "properties": {"score": {"type": "integer"}, "level": {"type": "string"}, "level_label": {"type": "string"}, "reasons": {"type": "array", "items": {"type": "string"}}, "as_of": {"type": "string"}, "disclaimer": {"type": "string"}}}, "source": {"type": "string"}, "as_of": {"type": "string"}, "disclosure_level": {"type": "string", "enum": ["public", "partner"]}}}}}}, "401": {"description": "Ключ неверен, отозван или истёк"}, "403": {"description": "Агент заблокирован или инструмент недоступен на его уровне"}, "422": {"description": "Неверный аргумент или персональные данные в запросе (не принимаются)"}, "429": {"description": "Лимит вызовов"}}, "security": [{}, {"bearerAuth": []}]}}, "/api/agent/v1/tools/get_property": {"post": {"operationId": "get_property", "summary": "Карточка квартиры или ЖК", "description": "Возвращает карточку квартиры (lot:ID) или жилого комплекса (complex:ID) из ответа search_properties: цена, площадь, этаж, срок, метро, паспорт качества. Не отдаёт контакты, закрытые предложения и внутренние данные.", "tags": ["tools"], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["property_id"], "properties": {"property_id": {"type": "string", "maxLength": 24, "pattern": "^(lot|complex):\\d+$", "examples": ["lot:123", "complex:45"], "description": "Идентификатор ТОЛЬКО из поля property_id элемента items ответа search_properties: «lot:123» (квартира) или «complex:45» (ЖК). Не придумывайте его и не подставляйте название: сначала вызовите search_properties (needs.places=[\"название ЖК\"])."}}}}}}, "responses": {"200": {"description": "Результат", "content": {"application/json": {"schema": {"type": "object", "description": "Единый формат ответа: данные, качество, источник, дата, уровень раскрытия.", "properties": {"data": {"type": "object"}, "quality": {"type": "object", "description": "Паспорт качества данных: общий балл 0-100, класс high/mid/low, причины на русском, оговорка ниже порога.", "properties": {"score": {"type": "integer"}, "level": {"type": "string"}, "level_label": {"type": "string"}, "reasons": {"type": "array", "items": {"type": "string"}}, "as_of": {"type": "string"}, "disclaimer": {"type": "string"}}}, "source": {"type": "string"}, "as_of": {"type": "string"}, "disclosure_level": {"type": "string", "enum": ["public", "partner"]}}}}}}, "401": {"description": "Ключ неверен, отозван или истёк"}, "403": {"description": "Агент заблокирован или инструмент недоступен на его уровне"}, "422": {"description": "Неверный аргумент или персональные данные в запросе (не принимаются)"}, "429": {"description": "Лимит вызовов"}}, "security": [{}, {"bearerAuth": []}]}}, "/api/agent/v1/tools/timeline_check": {"post": {"operationId": "timeline_check", "summary": "Срок сдачи и этап строительства", "description": "Проверяет срок сдачи и этап для квартиры или ЖК: срок по проектной декларации, срок застройщика, расхождение между ними, эскроу, история сдвигов и достоверность. Не обещает срок и не заменяет договор.", "tags": ["tools"], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["property_id"], "properties": {"property_id": {"type": "string", "maxLength": 24, "pattern": "^(lot|complex):\\d+$", "examples": ["lot:123", "complex:45"], "description": "Идентификатор ТОЛЬКО из поля property_id элемента items ответа search_properties: «lot:123» (квартира) или «complex:45» (ЖК). Не придумывайте его и не подставляйте название: сначала вызовите search_properties (needs.places=[\"название ЖК\"])."}}}}}}, "responses": {"200": {"description": "Результат", "content": {"application/json": {"schema": {"type": "object", "description": "Единый формат ответа: данные, качество, источник, дата, уровень раскрытия.", "properties": {"data": {"type": "object"}, "quality": {"type": "object", "description": "Паспорт качества данных: общий балл 0-100, класс high/mid/low, причины на русском, оговорка ниже порога.", "properties": {"score": {"type": "integer"}, "level": {"type": "string"}, "level_label": {"type": "string"}, "reasons": {"type": "array", "items": {"type": "string"}}, "as_of": {"type": "string"}, "disclaimer": {"type": "string"}}}, "source": {"type": "string"}, "as_of": {"type": "string"}, "disclosure_level": {"type": "string", "enum": ["public", "partner"]}}}}}}, "401": {"description": "Ключ неверен, отозван или истёк"}, "403": {"description": "Агент заблокирован или инструмент недоступен на его уровне"}, "422": {"description": "Неверный аргумент или персональные данные в запросе (не принимаются)"}, "429": {"description": "Лимит вызовов"}}, "security": [{}, {"bearerAuth": []}]}}, "/api/agent/v1/tools/quality_passport": {"post": {"operationId": "quality_passport", "summary": "Паспорт качества данных", "description": "Возвращает паспорт качества данных по квартире или ЖК: общий балл 0-100, класс и причины на русском (что неполно, устарело или не подтверждено). Это честная оценка данных на дату, а не гарантия точности.", "tags": ["tools"], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["property_id"], "properties": {"property_id": {"type": "string", "maxLength": 24, "pattern": "^(lot|complex):\\d+$", "examples": ["lot:123", "complex:45"], "description": "Идентификатор ТОЛЬКО из поля property_id элемента items ответа search_properties: «lot:123» (квартира) или «complex:45» (ЖК). Не придумывайте его и не подставляйте название: сначала вызовите search_properties (needs.places=[\"название ЖК\"])."}}}}}}, "responses": {"200": {"description": "Результат", "content": {"application/json": {"schema": {"type": "object", "description": "Единый формат ответа: данные, качество, источник, дата, уровень раскрытия.", "properties": {"data": {"type": "object"}, "quality": {"type": "object", "description": "Паспорт качества данных: общий балл 0-100, класс high/mid/low, причины на русском, оговорка ниже порога.", "properties": {"score": {"type": "integer"}, "level": {"type": "string"}, "level_label": {"type": "string"}, "reasons": {"type": "array", "items": {"type": "string"}}, "as_of": {"type": "string"}, "disclaimer": {"type": "string"}}}, "source": {"type": "string"}, "as_of": {"type": "string"}, "disclosure_level": {"type": "string", "enum": ["public", "partner"]}}}}}}, "401": {"description": "Ключ неверен, отозван или истёк"}, "403": {"description": "Агент заблокирован или инструмент недоступен на его уровне"}, "422": {"description": "Неверный аргумент или персональные данные в запросе (не принимаются)"}, "429": {"description": "Лимит вызовов"}}, "security": [{}, {"bearerAuth": []}]}}, "/api/agent/v1/tools/ask_fridi": {"post": {"operationId": "ask_fridi", "summary": "Вопрос Фриди", "description": "Задаёт Фриди вопрос по недвижимости (новостройки, ипотека, сделка, услуги ФРИДОМ); ответ проходит выходной контроль и ограничен квотой. Не принимает персональные данные, не даёт юридических и налоговых советов и не выдаёт контакты.", "tags": ["tools"], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["question"], "properties": {"question": {"type": "string", "maxLength": 600, "description": "Вопрос по-русски или по-английски, без персональных данных."}, "context": {"type": "object", "properties": {"property_id": {"type": "string", "maxLength": 24, "pattern": "^(lot|complex):\\d+$", "examples": ["lot:123", "complex:45"], "description": "Идентификатор ТОЛЬКО из поля property_id элемента items ответа search_properties: «lot:123» (квартира) или «complex:45» (ЖК). Не придумывайте его и не подставляйте название: сначала вызовите search_properties (needs.places=[\"название ЖК\"])."}}, "description": "Необязательно: объект, о котором вопрос."}}}}}}, "responses": {"200": {"description": "Результат", "content": {"application/json": {"schema": {"type": "object", "description": "Единый формат ответа: данные, качество, источник, дата, уровень раскрытия.", "properties": {"data": {"type": "object"}, "quality": {"type": "object", "description": "Паспорт качества данных: общий балл 0-100, класс high/mid/low, причины на русском, оговорка ниже порога.", "properties": {"score": {"type": "integer"}, "level": {"type": "string"}, "level_label": {"type": "string"}, "reasons": {"type": "array", "items": {"type": "string"}}, "as_of": {"type": "string"}, "disclaimer": {"type": "string"}}}, "source": {"type": "string"}, "as_of": {"type": "string"}, "disclosure_level": {"type": "string", "enum": ["public", "partner"]}}}}}}, "401": {"description": "Ключ неверен, отозван или истёк"}, "403": {"description": "Агент заблокирован или инструмент недоступен на его уровне"}, "422": {"description": "Неверный аргумент или персональные данные в запросе (не принимаются)"}, "429": {"description": "Лимит вызовов"}}, "security": [{}, {"bearerAuth": []}]}}, "/api/agent/v1/tools/handoff_link": {"post": {"operationId": "handoff_link", "summary": "Ссылка-передача клиента в Фриди", "description": "Создаёт ссылку на сайт ФРИДОМ, по которой человек сам продолжит разговор с Фриди с уже названными пожеланиями; контакт и согласие он даёт только там. Не принимает имя, телефон, почту и документы и ничего не отправляет от имени клиента.", "tags": ["tools"], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["needs"], "properties": {"needs": {"type": "object", "description": "Потребности клиента без персональных данных (профиль needs/1). Каждое значение кладите в СВОЁ поле: район, метро или название ЖК - places (список строк), бюджет - budget_max/budget_min числом в рублях («до 30 млн» = 30000000), комнаты - rooms. Свободный text - только для остального; из него сервер лишь пробует достать простой бюджет и комнаты. Незнакомые поля игнорируются.", "examples": [{"rooms": 2, "budget_max": 30000000, "places": ["Хамовники"]}, {"budget_max": 15000000, "rooms": 1, "places": ["Москва"]}, {"places": ["Фили Град"]}], "properties": {"budget_max": {"type": "integer", "minimum": 0, "maximum": 10000000000, "description": "Бюджет до, числом в рублях: «до 30 млн» = 30000000."}, "budget_min": {"type": "integer", "minimum": 0, "maximum": 10000000000, "description": "Бюджет от, числом в рублях: «от 10 млн» = 10000000."}, "rooms": {"type": "integer", "minimum": 0, "maximum": 10, "description": "Число комнат: 2 для «двушки» и «2-комнатной»; 0 - студия."}, "rooms_gte": {"type": "boolean", "description": "true: «столько комнат и больше»."}, "area_min": {"type": "integer", "minimum": 1, "maximum": 1000, "description": "Площадь от, м2."}, "area_max": {"type": "integer", "minimum": 1, "maximum": 1000, "description": "Площадь до, м2."}, "places": {"type": "array", "maxItems": 5, "items": {"type": "string", "maxLength": 80}, "description": "Район, станция метро или название ЖК - СПИСОК строк (до 5), например [\"Хамовники\"], [\"Сокол\"], [\"Фили Град\"]. Сюда, а не в text. Название ЖК находит этот ЖК в items. Без точного адреса."}, "metro_max_min": {"type": "integer", "minimum": 1, "maximum": 120, "description": "До метро не дольше, минут."}, "ready_by_year": {"type": "integer", "minimum": 2024, "maximum": 2040, "description": "Нужна квартира не позже этого года."}, "ready_only": {"type": "boolean", "description": "true: только сданные дома."}, "mortgage": {"type": "boolean", "description": "true: покупка с ипотекой (бюджет сверяется с ипотечной ценой)."}, "purpose": {"type": "string", "enum": ["live", "invest"], "description": "Цель: жить или вложение."}, "decoration": {"type": "array", "maxItems": 4, "items": {"type": "string", "enum": ["none", "pre_fine", "fine", "turnkey"]}, "description": "Отделка: none, pre_fine, fine, turnkey."}, "text": {"type": "string", "maxLength": 500, "description": "Остальные пожелания своими словами (этаж, вид, школа рядом). Район, бюджет и комнаты - в свои поля, не сюда. Без имени, телефона, почты и точного адреса."}}}}, "examples": [{"needs": {"rooms": 1, "budget_max": 15000000, "places": ["Москва"]}}]}}}}, "responses": {"200": {"description": "Результат", "content": {"application/json": {"schema": {"type": "object", "description": "Единый формат ответа: данные, качество, источник, дата, уровень раскрытия.", "properties": {"data": {"type": "object"}, "quality": {"type": "object", "description": "Паспорт качества данных: общий балл 0-100, класс high/mid/low, причины на русском, оговорка ниже порога.", "properties": {"score": {"type": "integer"}, "level": {"type": "string"}, "level_label": {"type": "string"}, "reasons": {"type": "array", "items": {"type": "string"}}, "as_of": {"type": "string"}, "disclaimer": {"type": "string"}}}, "source": {"type": "string"}, "as_of": {"type": "string"}, "disclosure_level": {"type": "string", "enum": ["public", "partner"]}}}}}}, "401": {"description": "Ключ неверен, отозван или истёк"}, "403": {"description": "Агент заблокирован или инструмент недоступен на его уровне"}, "422": {"description": "Неверный аргумент или персональные данные в запросе (не принимаются)"}, "429": {"description": "Лимит вызовов"}}, "security": [{}, {"bearerAuth": []}]}}, "/api/agent/v1/mcp": {"post": {"operationId": "mcp", "summary": "MCP (Streamable HTTP, JSON-RPC 2.0): initialize, tools/list, tools/call", "tags": ["protocols"], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object"}}}}, "responses": {"200": {"description": "JSON-RPC ответ"}, "202": {"description": "Уведомление принято"}}}}, "/api/agent/v1/a2a": {"post": {"operationId": "a2a", "summary": "A2A (минимальный): message/send. Формат уточняется.", "tags": ["protocols"], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object"}}}}, "responses": {"200": {"description": "JSON-RPC ответ"}}}}, "/api/agent/v1/services": {"get": {"operationId": "catalog_services", "summary": "Каталог сервисов маркетплейса агентов (только чтение, кэш 5 минут, ETag)", "tags": ["marketplace"], "parameters": [], "responses": {"200": {"description": "JSON"}, "304": {"description": "Не изменилось (If-None-Match)"}, "404": {"description": "Не найдено"}}}}, "/api/agent/v1/services/{slug}": {"get": {"operationId": "catalog_services_item", "summary": "Карточка сервиса каталога", "tags": ["marketplace"], "parameters": [{"name": "slug", "in": "path", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "JSON"}, "304": {"description": "Не изменилось (If-None-Match)"}, "404": {"description": "Не найдено"}}}}, "/api/agent/v1/rules": {"get": {"operationId": "catalog_rules", "summary": "Правила использования (последняя редакция: markdown, html, версия, хэш)", "tags": ["marketplace"], "parameters": [], "responses": {"200": {"description": "JSON"}, "304": {"description": "Не изменилось (If-None-Match)"}, "404": {"description": "Не найдено"}}}}}, "components": {"securitySchemes": {"bearerAuth": {"type": "http", "scheme": "bearer"}}}}