Myrspoven AI-API

myCoreAI wymienia dane i wartości zadane z każdym budynkiem za pośrednictwem jednego z kilku interfejsów — natywnego Myrspoven AI-API, zewnętrznego API dostawcy BMS/SCADA albo Myrspoven edge działającego lokalnie (on-premise). Ta strona opisuje każdy interfejs i odsyła do dokumentacji dostawcy tam, gdzie API należy do strony trzeciej.

Aby zobaczyć koncepcyjny model przepływu danych, zobacz Pierwsze kroki z integracją systemów.

Dostępne interfejsy API

Myrspoven AI-API (własne)

Chmura Myrspoven udostępnia natywne HTTP API do wymiany danych budynków z myCoreAI — odczytu bieżących wartości i wartości zadanych, wykrywania sygnałów, zapisu wartości zadanych oraz przesyłania danych sygnałów. Łącznik po stronie budynku integruje się, wywołując to API; na przykład SmartConnector działający w Schneider EcoStruxure Building Operation (EBO) używa go do odczytu zoptymalizowanych wartości zadanych i odesyłania wartości budynku.

API jest opisane w dokumentacji OpenAPI w tej sekcji, która jest wiążąca w kwestii punktów końcowych, schematów żądań/odpowiedzi oraz uwierzytelniania.

API BMS/SCADA stron trzecich

Niektóre platformy BMS i SCADA udostępniają własne HTTP API lub API dostawcy — na przykład Siemens Desigo i Web Port. Gdy jest ono używane, myCoreAI integruje się za jego pośrednictwem, aby wykrywać punkty, odczytywać wartości bieżące i historyczne oraz zapisywać wartości zadane. Interfejs API — punkty końcowe, schematy, formaty parametrów — należy do dostawcy, a dokumentacja dostawcy jest wiążącym źródłem informacji. Zakres integracji, poświadczenia i aktywacja są ustalane z Myrspoven podczas wdrożenia.

Myrspoven edge (lokalnie)

Tam, gdzie połączenie przez łącznik lub dostępne API dostawcy nie jest możliwe, Myrspoven edge działa w środowisku właściciela budynku, łączy się lokalnie z BMS i wymienia dane z chmurą Myrspoven. Edge komunikuje się wyłącznie wychodząco — pobiera potrzebne wartości zadane i zadania oraz odsyła wartości i wyniki — więc po stronie budynku nie są wymagane żadne otwarcia zapory dla ruchu przychodzącego.

Uwierzytelnianie i poświadczenia

Myrspoven AI-API używa tokenów bearer OAuth2. Client ID i secret są wydawane przez Myrspoven i przekazywane bezpiecznym kanałem — nigdy przez e-mail ani czat. Dokumentacja OpenAPI opisuje przepływ tokenów.

Tam, gdzie API dostawcy zewnętrznego wymaga uwierzytelniania (zwykle konta serwisowego do dostępu zapisu), poświadczenia są tworzone po stronie dostawcy i przekazywane Myrspoven bezpiecznym kanałem. Punkty końcowe tylko do odczytu na niektórych platformach działają bez uwierzytelniania. Operacje zapisu zawsze wymagają dedykowanego konta serwisowego.

Wymagane zakresy i uprawnienia są określane przez Myrspoven dla każdej integracji podczas wdrożenia.

Środowiska

Integracje są konfigurowane dla każdego budynku w odniesieniu do jednego środowiska produkcyjnego. Zmiany, które mogłyby wpłynąć na działający budynek, są uzgadniane z Myrspoven, a bezpiecznym sposobem testowania jest wstrzymanie zapisu dla testowanego budynku.

Obsługa błędów

Dla natywnego Myrspoven AI-API kody odpowiedzi i schematy błędów są opisane w dokumentacji OpenAPI. Dla interfejsów stron trzecich obsługa błędów jest zgodna z konwencjami dostawcy, który jest właścicielem danego interfejsu. Gdy myCoreAI nie może połączyć się z BMS, przestaje zapisywać wartości zadane, a BMS nadal działa według własnej logiki — budynek funkcjonuje normalnie; wstrzymana jest tylko optymalizacja, dopóki połączenie nie zostanie przywrócone.

Limity szybkości

Częstotliwość odczytów i zapisów jest uzgadniana dla każdego budynku podczas uruchomienia. Odczyty zwykle odbywają się co jedną do pięciu minut; zapisy wartości zadanych wykonywane są ze stałą częstotliwością — zwykle co 15 minut — w oparciu o najnowszy wynik optymalizacji. Tam, gdzie dostawca zewnętrzny narzuca własne limity szybkości, są one opisane przez dostawcę i dostrajane w koordynacji z Myrspoven.

Uzyskiwanie pomocy

W przypadku potrzeb integracyjnych wykraczających poza opisane tutaj interfejsy skontaktuj się bezpośrednio z Myrspoven.