> 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 swój System Zarządzania Budynkiem (BMS) lub urządzenie brzegowe Myrspoven. Niektóre obiekty udostępniają zamiast tego dane — liczniki energii, czujniki klimatu wewnętrznego, systemy obecności — przez API dostawcy. Ta strona wyjaśnia, kiedy ma zastosowanie integracja przez API, jak wygląda oraz gdzie znajduje się pełna dokumentacja.

## Kiedy ma zastosowanie integracja przez API

myCoreAI korzysta z integracji przez 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 chmurowe API.
* Sam BMS udostępnia dostępny w sieci REST API, punkt końcowy OPC UA lub SDK dostawcy, z którego myCoreAI może bezpośrednio odczytywać i do którego może zapisywać.

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

## Struktura integracji przez API

Wszystkie trzy przypadki mają tę samą strukturę: Myrspoven przechowuje dane uwierzytelniające do odczytu z API dostawcy (a tam, gdzie to istotne, także do zapisu) według uzgodnionego harmonogramu. Po zaimportowaniu 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 między dostawcami:

* Konto lub klucz API z dostępem do odczytu oraz dostępem do zapisu, gdy myCoreAI musi odsyłać wartości zadane.
* Potwierdzone przypisanie identyfikatorów liczników, identyfikatorów czujników lub sygnałów do budynków i stref.
* Osoba kontaktowa techniczna do uruchomienia.

Dokładne dane uwierzytelniające, punkty końcowe i formaty identyfikatorów są specyficzne dla dostawcy i dokumentowane dla każdego budynku podczas przeglądu technicznego.

## Koszt

Platformy zewnętrzne zwykle pobierają opłaty za dostęp do API na podstawie własnej umowy. Myrspoven nie pobiera dodatkowej opłaty za integrację. Dodanie łącznika do dostawcy, który nie jest jeszcze obsługiwany, ocenia się indywidualnie — zgłoś taką prośbę 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](/myrspoven-docs/myrspoven-docs-pl/zaufanie-i-bezpieczenstwo/overview.md).

## Powiązane

* [integracjach BMS](/myrspoven-docs/myrspoven-docs-pl/integracje/overview/bms-integrations.md): bezpośrednie połączenia z BMS, w tym REST, OPC UA i BACnet.
* [Dane energetyczne](/myrspoven-docs/myrspoven-docs-pl/integracje/overview/energy-data.md): Mestro, Metry i ręczne przesyłanie.
* Czujniki klimatu wewnętrznego: platformy czujników zewnętrznych są wymienione w [Przegląd integracji](/myrspoven-docs/myrspoven-docs-pl/integracje/overview.md).
* [Dokumentacji dla deweloperów](/myrspoven-docs/myrspoven-docs-pl/dokumentacja-dla-deweloperow/myrspoven-ai-api.md): pełnej dokumentacji API.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/integracje/api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.