> For the complete documentation index, see [llms.txt](https://docs.myrspoven.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/dokumentacja-dla-deweloperow/myrspoven-ai-api.md). # Myrspoven AI-API myCoreAI integruje się poprzez System Zarządzania Budynkiem (BMS) — odczytując wartości czujników i zapisując wartości zadane za pośrednictwem protokołów, które BMS już obsługuje (Modbus, BACnet, SmartConnector, CtAPI i inne). Ta strona dokumentuje interfejsy API istotne dla integracji myCoreAI, odsyła do dokumentacji dostawców tam, gdzie interfejs API należy do podmiotu trzeciego, oraz jasno określa, co nie jest publicznie dostępne. Dla koncepcyjnego modelu przepływu danych zobacz [Pierwsze kroki z integracją systemu](/myrspoven-docs/myrspoven-docs-pl/integracje/overview.md). ## Dostępne interfejsy API ### Protokoły BMS W niemal każdym budynku myCoreAI integruje się przez standardowe protokoły BMS, a nie przez HTTP API. Komponent brzegowy Myrspoven, wdrożony w środowisku właściciela budynku, odpytuje BMS o wartości rzeczywiste i zapisuje z powrotem obliczone wartości zadane. Komponent brzegowy łączy się wychodząco z chmurą Myrspoven. Po stronie budynku nie są wymagane żadne otwarcia zapory dla ruchu przychodzącego. ### Larmia EVO SCADA Open API (podmiot trzeci) Gdy BMS to Larmia EVO SCADA, myCoreAI integruje się przez otwarte REST API Larmii, aby wykrywać punkty, odczytywać historię i wartości w czasie rzeczywistym oraz zapisywać nadpisania wartości zadanych. Warstwa API — punkty końcowe, schematy, formaty parametrów — należy do Larmii. **Oficjalna dokumentacja Larmii** jest miarodajnym źródłem odniesienia. Zakres integracji i włączenie po stronie Larmii opisano na [stronie integracji Larmia EVO SCADA](broken://pages/a004f2f5416164bac535d59879a4256e45f5212d) . ### Inne interfejsy API BMS Niewielka liczba platform BMS udostępnia własne interfejsy HTTP lub interfejsy dostawcy (na przykład SmartConnector firmy Schneider i CtAPI firmy Citect). W takich przypadkach API należy do dostawcy BMS, a zastosowanie ma dokumentacja dostawcy. Dostęp jest uzgadniany z Myrspoven podczas onboardingu. ## Uwierzytelnianie i poświadczenia Gdy interfejs API dostawcy wymaga uwierzytelniania (zwykle konta serwisowego do dostępu z możliwością zapisu), poświadczenia są tworzone po stronie dostawcy i przekazywane Myrspoven bezpiecznym kanałem — nigdy przez e-mail ani czat. Punkty końcowe tylko do odczytu na niektórych platformach (w tym Larmia EVO SCADA) działają bez uwierzytelniania. Zapis zawsze wymaga dedykowanego konta serwisowego. Wymagane zakresy i uprawnienia są specyficzne dla danego BMS; Myrspoven określa je dla każdej integracji podczas onboardingu. ## Środowiska Integracje są konfigurowane dla każdego budynku względem jednego środowiska produkcyjnego. Myrspoven nie udostępnia oddzielnego sandboxu ani środowiska stagingowego. Zmiany, które mogłyby wpłynąć na działający budynek, są uzgadniane z Myrspoven; bezpieczniejszym rozwiązaniem jest wstrzymanie zapisów dla testowanego budynku zamiast uruchamiania równoległego środowiska. ## Obsługa błędów Obsługa błędów przebiega zgodnie z konwencjami dostawcy, który jest właścicielem danego interfejsu (Larmia, Schneider itd.). W przypadku ścieżki opartej na protokołach BMS semantyka błędów jest określona przez protokół — kody wyjątków Modbus, klasy błędów BACnet i tak dalej. Jeśli 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 nadal funkcjonuje normalnie; jedynie optymalizacja zostaje wstrzymana do czasu przywrócenia połączenia. ## Limity częstotliwości Częstotliwość odpytywania jest uzgadniana dla każdego budynku podczas uruchomienia. Typowe odczyty odbywają się co minutę do co kilka minut; zapisy są wykonywane w stałym rytmie — zazwyczaj co godzinę — po zakończeniu nowego cyklu optymalizacji. Limity narzucone przez dostawcę są opisane w jego dokumentacji i dostrajane w koordynacji z Myrspoven, tak aby rytm odczytów i zapisów pozostawał zgodny z pętlą sterowania. ## Obecnie niedostępne * **Brak ogólnego interfejsu Myrspoven REST API dla klientów lub partnerów.** Raportowanie, zarządzanie sygnałami i ręczne przesyłanie danych odbywają się przez myPortal. * **Brak opublikowanego interfejsu webhooków.** myCoreAI nie przesyła zdarzeń do systemów klienta za pomocą wywołań zwrotnych HTTPS. * **Brak opublikowanego SDK ani biblioteki klienckiej.** Potrzeby integracyjne wymagające któregokolwiek z powyższych należy zgłaszać bezpośrednio do Myrspoven. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/dokumentacja-dla-deweloperow/myrspoven-ai-api.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.