> 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/integracje/api.md).

# API

Większość budynków łączy się z myCoreAI przez system zarządzania budynkiem (BMS) albo warstwę brzegową Myrspoven. W niektórych lokalizacjach dane — liczniki energii, czujniki klimatu wewnętrznego, systemy obecności — są zamiast tego udostępniane przez interfejs 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 są własnością platformy zewnętrznej, która udostępnia chmurowe API.
* Sam BMS udostępnia dostępny przez sieć punkt końcowy REST API, punkt końcowy OPC UA albo SDK dostawcy, z którego myCoreAI może bezpośrednio odczytywać i zapisywać dane.

Jeśli to możliwe, podłączenie liczników lub czujników do BMS jest prostszą drogą — mniej ruchomych części, brak kosztów dostawcy zewnętrznego, jedno połączenie do utrzymania. Integracja API jest właściwym wyborem, gdy dane istnieją tylko poza BMS albo gdy sam BMS jest API.

## Kształt integracji API

Wszystkie trzy przypadki mają ten sam kształt: Myrspoven przechowuje poświadczenia, aby odczytywać z API dostawcy (a tam, gdzie ma to zastosowanie, także zapisywać do niego) 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.

Dostarczane przez klienta dane wejściowe 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 odsyłać wartości zadane.
* Potwierdzoną mapę identyfikatorów liczników, identyfikatorów czujników lub sygnałów do budynków i stref.
* Osoba techniczna do kontaktu przy uruchomieniu.

Dokładne poświadczenia, punkty końcowe i formaty identyfikatorów zależą od dostawcy i są 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 łącznika dostawcy, który nie jest jeszcze obsługiwany, jest oceniane indywidualnie — złóż prośbę za pośrednictwem Myrspoven.

## Bezpieczeństwo

Poświadczenia 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](/myrspoven-docs/myrspoven-docs-pl/zaufanie-i-bezpieczenstwo/overview.md).

## Powiązane

* BMS — bezpośrednie połączenia z BMS, w tym warianty REST / OPC UA / BACnet.
* Dane energetyczne — Mestro, Metry i ręczne przesyłanie.
* Klimat wewnętrzny — integracje API zewnętrznych dostawców czujników.
* Pełna dokumentacja API — zobacz [Dokumentacja dla deweloperów](/myrspoven-docs/myrspoven-docs-pl/dokumentacja-dla-deweloperow/myrspoven-ai-api.md) (rozdział 7).


---

# 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/integracje/api.md?ask=<question>
```

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.