External API

Инженерные данные зданий через BuildingData API

Подключайте диспетчеризацию, аналитику и корпоративные системы к BuildingData. Работайте с объектами, оборудованием, точками, текущими значениями, историей, семантическими связями, аномалиями, KPI, инцидентами и заявками через единый API.

Справочник API Swagger OpenAPI JSON

HTTPS · Bearer authentication · read-only

Ресурсы API

Объекты

Sites, Equipment и нормализованные Points.

Текущие значения

Значение, timestamp, качество и единица измерения.

История

История точек с raw-данными и агрегациями 1m, 5m, 15m, 1h.

Семантика

Опубликованная семантическая модель объекта и инженерные связи.

Аналитика

Аномалии и сводные KPI по объектам.

Эксплуатация

Инциденты и заявки.

Подключение

Получите credential BuildingData выдает credential с доступом к согласованным объектам.

Авторизуйтесь Передавайте credential в заголовке Authorization: Bearer <client_id>.<client_secret>.

Начните с объектов Запросите GET /v1/sites, затем переходите к оборудованию, точкам и данным.

Первый запрос

Пример запроса после получения credential.

curl \
  -H 'Authorization: Bearer <client_id>.<client_secret>' \
  https://api.buildingdata.ru/v1/sites

Доступ

API работает по HTTPS и предоставляет доступ к данным в режиме чтения. Каждый credential имеет собственные разрешения и scope по объектам. Для production-интеграции храните client_secret на backend или BFF.