В системе «Реформа ЖКХ» (далее система) для взаимодействия с внешними системами реализован интерфейс программирования приложений (API). С помощью API внешняя система имеет возможность получать и предоставлять информацию по организациям, осуществляющим деятельность по управлению многоквартирными домами и домам, находящимся в их управлении, получать данные о реализации региональных программ по переселению граждан из аварийного жилищного фонда, а также данные по мониторингу реализации субъектами РФ региональных программ капитального ремонта общего имущества в МКД.

Для осуществления взаимодействия по предоставлению информации об управляющей организации и домам в её обслуживании внешняя система подает запрос управляющей организации на раскрытие информации от ее лица. Внешняя система может осуществлять обмен данными только после одобрения такого запроса управляющей организацией.

Чтобы получить доступ к информации о реализации региональных программ переселения граждан из аварийного жилищного фонда или к информации по мониторингу реализации рег.программ капитального ремонта необходимо подать запрос на чтение данных, одобрение которого администратором системы позволит получать данные с помощью API.

Получить разрешение на использование API системы «Реформа ЖКХ» может любая организация или частное лицо. Для этого необходимо выполнить все перечисленные пункты порядка подключения к использованию API системы описанные ниже.

API позволяет:

• осуществить авторизацию для получения доступа к использованию API-методов;
• получить данные организаций, раскрывших сведения о своей деятельности согласно Постановлению Правительства № 731 в системе, а также данные по обслуживаемым ими домам;
• загрузить (обновить) данные организаций, зарегистрированных в системе, отредактировать список обслуживаемых ими домов, а также загрузить в систему данные по этим домам;
• получить данные о реализации региональных программ по переселению граждан из аварийного жилищного фонда;
• получить данные по мониторингу реализации субъектами РФ региональных программ капитального ремонта общего имущества в многоквартирных домах.

Входные структуры данных GET и SET - методов передаются в теле запроса. Обмен ведется согласно регламенту. В настоящее время сервис API поддерживает два протокола в зависимости от типа запрашиваемой информации.

В протоколах генерируются WSDL-документы, описывающие формат данных для взаимодействия, доступные в двух стилях: RPC\encoded и Document\literal.

Версии документов также различаются по назначению: тестовые документы предоставляются для прохождения тестирования межсистемного взаимодействия, тогда как использование рабочих WSDL-документов предполагает уже пройденное тестирование и готовность получения или загрузки данных посредством API на рабочую версию системы.

Порядок подключения к использованию API системы на чтение данных:

1. Создать учетную запись в системе reformagkh.ru;
2. Заполнить бланк заявления и прислать скан-копию на адрес api@reformagkh.ru;
3. Ознакомиться с регламентом взаимодействия и WSDL-документами;
4. Получить подтверждение от администратора системы о возможности использования рабочей версии системы;
5. Использовать API для: получения данных по управляющим организациям и домам в управлении; получения данных о реализации региональных программ по переселению граждан из аварийного жилищного фонда.

Порядок подключения к использованию API системы на чтение и предоставление данных:

1. Создать одинаковые учетные записи в системе reformagkh.ru и p-api-beta.reformagkh.ru (тестовая система);
2. Заполнить бланк заявления и прислать скан-копию на адрес api@reformagkh.ru;
3. Ознакомиться с регламентом взаимодействия и WSDL-документами;
4. Получить подтверждение от администратора системы о возможности использовать тестовый сайт для отладки взаимодействия;
5. В случае создания новой заявки на регистрацию управляющей организации (п. 6.1.7 Регламента) необходимо обратиться к администратору системы с просьбой одобрить данную заявку в целях тестирования взаимодействия;
6. В случае создания запроса на предоставление информации уже зарегистрированной управляющей организации (п. 6.1.3 Регламента) необходимо обратиться к администратору системы с просьбой одобрить данный запрос в целях тестирования взаимодействия;
7. Проверить изменение информации по управляющей организации и домам в управлении на сайте p-api-beta.reformagkh.ru;
8. После настройки полного взаимодействия с тестовой версией системой необходимо обратиться к администратору системы «Реформа ЖКХ» с просьбой предоставить доступ для взаимодействия с системой;
9. Получить подтверждение от администратора системы о возможности использования рабочей версии системы;
10. Использовать API для: создания заявок на регистрацию управляющих организаций, подачу запроса на предоставление информации уже зарегистрированным организациям; предоставления информации по управляющим организациям и домам в управлении; получения данных о реализации региональных программ по переселению граждан из аварийного жилищного фонда.

Ограничение времени работы сервиса не установлено.

SOAP-протокол JSON RPC-протокол

API по раскрытию информации управляющими организациями, ТСЖ и ЖСК по текущим формам анкет организаций и домов поддерживает SOAP - протокол. В соответствии с 988 ПП РФ от 23 сентября 2014 года вступили в силу новые формы Стандарта. В API добавлены новые методы согласно изменениям Постановления Правительства № 731, внесенным Постановлением Правительства № 988 от 27.09.2014 г. Описанные в регламенте методы (по формам предыдущей редакции 731 ПП РФ) используются для изменения данных анкет отчетного периода до 2014 года включительно, в том числе и после его архивации. 

Список внешних систем, осуществляющих обмен информацией с помощью API системы Реформа ЖКХ размещен на официальном сайте «Реформа ЖКХ».

Для Управляющих организаций:

По вопросам заполнения данных во внешних системах и переноса их в систему обращайтесь к оператору Внешней Системы, которой Вами было предоставлено разрешение на раскрытие данных.