API для клиентских приложений и интеграторов

Нормализованные инженерные данные здания через один API

Подключайте собственную диспетчеризацию, АРМ, аналитику и корпоративные сервисы к Customer Central. Протоколы, ноды и нормализация остаются ниже API, приложение работает с объектами, оборудованием, точками и историей.

Открыть Swagger OpenAPI JSON

v1 · read-only · scoped Bearer access

Как данные проходят через BuildingData

BMS / SCADA / PLC Источники на объекте

BuildingData Node Сбор и локальная устойчивость

Project Haystack Нормализация и связи

Customer Central Хранение и инженерный контекст

External API v1 Стабильный внешний контракт

Ваше приложение ОДС, АРМ, аналитика, интеграции

Что доступно сейчас

Объекты и оборудование

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

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

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

История

Raw и агрегации 1m, 5m, 15m, 1h.

Семантика

Опубликованная immutable-модель объекта с Project Haystack-контекстом.

Аномалии и KPI

Состояние объектов, проблемные точки и evidence.

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

Read-only инциденты и заявки из Customer Central.

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

Получите отдельный credential и запросите список доступных объектов.

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

Граница доступа

Каждый credential ограничен разрешениями и Organization/Site scope. Internal IAM, Global Engineering, Node lifecycle, TimescaleDB, Haxall и промышленные протоколы через этот API не публикуются.

Batch-запросы, cursor pagination и near-real-time поток входят в следующий этап API и не считаются частью текущего контракта.