RiskAssessmentV2: структура API-ответа

Описание документа: Детализированная схема результатов проверок по продукту риск-оценки недвижимости и объекта.

Файл: ./doc_risk.html. Основная документация API: ./doc.html.

Документация по API ответу

11. Проверка на объект культурного наследия (task_type: cultural_object)

Задача проверяет, относится ли объект по адресу/кадастровому номеру к Реестру объектов культурного наследия (ОКН) и, при наличии, возвращает публичные сведения из реестра.

Источник данных: государственный реестр объектов культурного наследия (ОКН). Значения перечислимых полей categoryType, objectType, unesco, status, typologies — это коды и подписи, приходящие из внешнего реестра; используйте текстовое значение value для отображения в UI.

Сводка по задаче cultural_object

Поле Тип Описание
task_id Строка (UUID) Идентификатор задачи.
status Строка Статус выполнения задачи. Для завершённых: done.
task_type Строка Всегда cultural_object.
display_name Строка Человекочитаемое имя проверки.
number_of_starts Int Сколько раз задача запускалась.
max_restarts_count Int Разрешённый максимум перезапусков.
started_at Дата-время (ISO 8601) Момент старта.
ended_at Дата-время (ISO 8601) Момент завершения.
missing_requirements Массив Список отсутствующих входных данных; пустой массив — всё ОК.

Объект task_result

Поле Тип Описание
execution_number Int Порядковый номер исполнения.
hash_sum Строка Хеш входных параметров.
image Строка (URL) Опционально, миниатюра/обложка (может быть пусто).
images Массив Опционально, дополнительные изображения (может быть null).
input Объект Входные параметры задачи (см. ниже).
result Объект Итог выполнения (см. ниже).
text Строка Технический комментарий (например, "OK").
time Дата-время Опционально, момент фиксации (может быть "0001-01-01T00:00:00Z").

Входные данные task_result.input

Поле Тип Обязательное Описание
address Строка Нет* Полный адрес объекта.
kad_num Строка Нет* Кадастровый номер (формат: NN:NN:NNNNNNN:NNNN).
*Правило заполнения: достаточно одного из полей (address или kad_num). При наличии обоих — используются совместно для повышения точности.

Результат task_result.result

Поле Тип Описание
status Строка Состояние результата: Success (найден), not found (не найден), либо иные сервисные статусы (например, error — по соглашению вашей платформы).
answer Объект или null При Success содержит сведения из реестра ОКН (см. схему answer ниже). При not found — null.
Объект answer (при status = "Success")
Поле Тип Описание
status Int Код внутреннего статуса ответа (0 — успешно). Не используйте в UI — это техническое поле.
full_address Строка Нормализованный адрес из реестра.
native_id Int Внутренний идентификатор в источнике (может быть 0 или отсутствовать).
native_name Строка Название в источнике (может быть пустой строкой).
data Объект Структурированные сведения об ОКН (см. data.general ниже).
Объект data.general
Поле Тип Описание
id Int Идентификатор объекта в реестре ОКН.
name Строка Официальное наименование ОКН.
address.fullAddress Строка Адрес ОКН.
address.mapPosition Объект Геопозиция (может не заполняться).
categoryType Объект {id, value} Категория значения ОКН (напр., Регионального значения).
objectType Объект {id, value} Тип объекта (напр., Памятник).
regNumber Строка Регистрационный номер в реестре.
conNumber Строка Учетный/архивный номер (если есть).
createDate Строка Период/дата создания (может быть в виде текста, напр. XIX в.).
isActual Bool Признак актуальности записи.
documents[] Массив Нормативные документы (дата, номер, название, архивная ссылка).
photo Объект Информация о фото (может быть пусто; обычно есть url на карточку объекта).
region Объект {id, value} Субъект РФ.
status Объект {id, value} Статус охраны/наличия признаков (по источнику).
unesco Объект {id, value} Признак включения в объекты ЮНЕСКО (обычно нет).
typologies[] Массив объектов {id, value} Классификация (напр., Памятник градостроительства и архитектуры).

Возможные значения result.status для cultural_object

Значение Описание
Success Объект найден в реестре ОКН; поле answer заполнено.
not found Объект не найден; answer = null.
error Ошибка обработки/доступа к источнику (если используется в вашей платформе).

Примеры

А) Не найден в реестре

{
  "task_id": "dfad7099-4dfd-493e-81a3-248ceacfcc0d",
  "status": "done",
  "task_type": "cultural_object",
  "display_name": "Проверка на объект культурного наследия",
  "number_of_starts": 1,
  "max_restarts_count": 3,
  "started_at": "2025-09-03T08:40:08.954367202Z",
  "ended_at": "2025-09-03T08:40:09.319566879Z",
  "task_result": {
    "execution_number": 1,
    "hash_sum": "8a1fb01c8433be3e2c015d46a07ed98867f3440c3238603befa5cbb1d103d242",
    "image": "",
    "images": null,
    "input": {
      "address": "Российская Федерация, город Москва, ... , дом 13, квартира 2",
      "kad_num": "77:04:0004021:9847"
    },
    "result": {
      "answer": null,
      "status": "not found"
    },
    "text": "OK",
    "time": "0001-01-01T00:00:00Z"
  },
  "missing_requirements": []
}

Б) Найден в реестре

{
  "status": "done",
  "task_type": "cultural_object",
  "display_name": "Проверка на объект культурного наследия",
  "task_result": {
    "execution_number": 1,
    "input": {
      "address": "Республика Татарстан Татарстан, г.Казань, ул. Хади Атласи, д.28",
      "kad_num": "16:50:011124:724"
    },
    "result": {
      "status": "Success",
      "answer": {
        "status": 0,
        "full_address": "Республика Татарстан, г. Казань, ул. Хади Атласи, д. 28",
        "native_id": 0,
        "native_name": "",
        "data": {
          "general": {
            "id": 254517,
            "name": "Дом  К.Л.Мюфке",
            "address": {
              "fullAddress": "Республика Татарстан, г. Казань, ул. Хади Атласи, д. 28",
              "mapPosition": { "coordinates": null, "type": "" }
            },
            "categoryType": { "id": "2", "value": "Регионального значения" },
            "objectType": { "id": "1", "value": "Памятник" },
            "regNumber": "161710792020005",
            "conNumber": "16-65554",
            "createDate": "XIX в.",
            "isActual": true,
            "documents": [
              {
                "date": "1987-07-27",
                "number": "320",
                "name": "Постановление Совета Министров Татарской АССР ...",
                "archive": { "id": 2450622, "url": "https://okn-mk.mkrf.ru/maps/show/id/2450622" }
              }
            ],
            "photo": { "preview": "", "title": "2450640", "url": "https://okn-mk.mkrf.ru/maps/show/id/2450640" },
            "region": { "id": "16", "value": "Республика Татарстан (Татарстан)" },
            "status": { "id": "2", "value": "нет" },
            "unesco": { "id": "2", "value": "нет" },
            "typologies": [ { "id": "3", "value": "Памятник градостроительства и архитектуры" } ]
          },
          "info": {
            "category": "heritage",
            "createDate": "2017-04-13T12:18:49Z",
            "path": "/cdm/v2/heritages/1/254517"
          }
        }
      }
    },
    "text": "OK",
    "time": "0001-01-01T00:00:00Z"
  },
  "missing_requirements": []
}

Справочники (проксированы из источника)

categoryType

Пример id Пример value Комментарий
"1" Федерального значения Пример (может отличаться)
"2" Регионального значения Как в примере выше
"3" Местного (муниципального) значения Пример

objectType

Пример id Пример value
"1" Памятник
"2" Ансамбль
"3" Достопримечательное место

unesco / status

Пример id Пример value Значение
"1" да Присутствует признак
"2" нет Отсутствует признак

typologies[]

Пример id Пример value
"3" Памятник градостроительства и архитектуры

Примечания