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

## 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](/myrspoven-docs/myrspoven-docs-pl/dokumentacja-dla-programistow/myrspoven-ai-api.md).


---

# 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.