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

# Przegląd

Materiały referencyjne dla deweloperów i integratorów systemów pracujących z myCoreAI programowo — łączenie budynków, wymiana danych z chmurą Myrspoven lub tworzenie narzędzi na bazie istniejącej integracji. Każda strona opisuje konkretny interfejs (API, protokół, krok konfiguracji) na poziomie endpointu lub protokołu.

**Integratorzy:** zacznij od **Pierwsze kroki z integracją systemu** w rozdziale Integracje — wyjaśnia, jak edge, chmura Myrspoven i myCoreAI współdziałają, zanim jakiekolwiek szczegóły endpointów staną się przydatne.

**Deweloperzy narzędzi:** strony API opisują interfejs odczytu/zapisu, który myCoreAI udostępnia po podłączeniu budynku — wykrywanie sygnałów, historię, ręczne przesyłanie i zapisywanie wartości zadanych.

## Spis treści

### API

Jak chmura Myrspoven udostępnia dane i przyjmuje zapisy. Obejmuje uwierzytelnianie, podstawowe adresy URL, endpointy (odczyt, zapis, ręczne przesyłanie, zarządzanie sygnałami), limity zapytań, obsługę błędów i przykłady użycia.

### Interfejsy API firm trzecich

Jeśli integracja opiera się na API dostawcy BMS lub SCADA, dokumentacja tutaj opisuje **jak Myrspoven korzysta z API dostawcy** — odczyty, zapisy i wymaganą konfigurację po stronie dostawcy — oraz odsyła do dokumentacji referencyjnej dostawcy po szczegóły na poziomie endpointów. Dokumentacja dostawcy jest rozstrzygająca w kwestii specyfiki endpointów.

### Komponenty edge i lokalne

Dokumentacja referencyjna dla Myrspoven edge — lokalnej aplikacji, która łączy chmurę Myrspoven z systemem zarządzania budynkiem (BMS) w budynku. Obejmuje wymagania środowiskowe, komunikację z chmurą opartą na odpytywaniu wychodzącym oraz konfigurację.

## Poza zakresem

* **Konfiguracja protokołu BMS** (Schneider, Siemens, WebPort, Modbus, BACnet itp.) znajduje się w **Integracje** rozdziale.
* **Instrukcje operacyjne** — dane uwierzytelniające VPN, utwardzanie serwerów, procedury wdrożenia — nie są publiczne i są obsługiwane bezpośrednio z Myrspoven.
* **Wewnętrzne narzędzia i potoki** — własny proces budowania, testowania i wdrażania Myrspoven — jest poza zakresem dokumentacji dla partnerów.

## Konwencje

* Przykłady używają `curl` o ile nie jest demonstrowane konkretne SDK.
* Czasy są podawane w formacie ISO 8601 w UTC, chyba że zaznaczono inaczej.
* „Chmura Myrspoven” oznacza hostowany backend; „edge” oznacza komponent lokalny; „myCoreAI” oznacza agenta AI działającego w chmurze.
* Dane uwierzytelniające w przykładach są zastępcze. Działające dane uwierzytelniające są udostępniane podczas integracji za pośrednictwem bezpiecznego kanału.

## Uzyskanie pomocy

Zgłaszaj błędy lub braki do Myrspoven. Jeśli dokumentacja dostawcy i te strony różnią się, w kwestii szczegółów na poziomie endpointów rozstrzyga dokumentacja dostawcy.


---

# 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/overview.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.