API

Większość budynków łączy się z myCoreAI poprzez swój System Zarządzania Budynkiem (BMS) lub brzeg Myrspoven. Niektóre obiekty zamiast tego udostępniają dane — liczniki energii, czujniki klimatu wewnętrznego, systemy zajętości — przez API dostawcy. Ta strona wyjaśnia, kiedy ma zastosowanie integracja API, jak wygląda i gdzie znajduje się pełna dokumentacja referencyjna.

Kiedy ma zastosowanie integracja API

myCoreAI korzysta z integracji API, gdy:

• Dane energetyczne pochodzą z platformy zewnętrznej (na przykład Mestro lub Metry) zamiast z BMS.
• Czujniki klimatu wewnętrznego należą do platformy zewnętrznej, która udostępnia API w chmurze.
• Sam BMS udostępnia dostępne przez sieć REST API, punkt końcowy OPC UA lub SDK dostawcy, z których myCoreAI może bezpośrednio odczytywać i do których może bezpośrednio zapisywać.

Włączenie liczników lub czujników do BMS jest prostszą drogą, gdy to możliwe — mniej elementów składowych, brak kosztów dostawcy zewnętrznego, jedno połączenie do utrzymania. Integracja API jest właściwym wyborem, gdy dane istnieją wyłącznie poza BMS albo gdy sam BMS jest API.

Struktura integracji API

We wszystkich trzech przypadkach obowiązuje ta sama struktura: Myrspoven przechowuje dane uwierzytelniające do odczytu z API dostawcy (a tam, gdzie to istotne, także do zapisu) według uzgodnionego harmonogramu. Po zebraniu sygnały są traktowane identycznie jak sygnały BMS — model myCoreAI i pulpity myPortal są niezależne od transportu.

Dane wejściowe dostarczane przez klienta są również spójne u wszystkich dostawców:

• Konto lub klucz API z dostępem do odczytu oraz dostępem do zapisu tam, gdzie myCoreAI musi wysyłać z powrotem wartości zadane.
• Potwierdzone przypisanie identyfikatorów liczników, identyfikatorów czujników lub sygnałów do budynków i stref.
• Techniczna osoba kontaktowa ds. uruchomienia.

Dokładne poświadczenia, punkty końcowe i formaty identyfikatorów są zależne od dostawcy i dokumentowane dla każdego budynku podczas przeglądu technicznego.

Koszt

Platformy zewnętrzne zazwyczaj pobierają opłaty za dostęp do API na podstawie własnej umowy. Myrspoven nie pobiera osobnej opłaty za integrację. Dodanie konektora dostawcy, który nie jest jeszcze obsługiwany, jest oceniane indywidualnie — można go zgłosić przez Myrspoven.

Bezpieczeństwo

Dane uwierzytelniające API są przechowywane w chmurze Myrspoven i używane wyłącznie do uzgodnionej integracji. Zakres nigdy nie wykracza poza skonfigurowane sygnały odczytu/zapisu. Zobacz Bezpieczeństwo.

Powiązane

• BMS — bezpośrednie połączenia BMS, w tym warianty REST / OPC UA / BACnet.
• Dane energetyczne — Mestro, Metry i ręczne przesyłanie.
• Klimat wewnętrzny — integracje API z dostawcami czujników zewnętrznych.
• Pełna dokumentacja API — zobacz Dokumentacja dla deweloperów.