> 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 systemowych pracujących z myCoreAI programowo — łączących budynek, wymieniających dane z chmurą Myrspoven lub budujących narzędzia na bazie istniejącej integracji.

Sekcja ma dwie części: **strona narracyjna** która wyjaśnia, który interfejs integracyjny ma zastosowanie do budynku i jak działa, oraz **odwołaniu OpenAPI** która dokumentuje autorski interfejs Myrspoven AI-API endpoint po endpoincie.

**Integratorzy:** zacznij od **Przegląd integracji** — wyjaśnia, jak współdziałają edge, chmura Myrspoven i myCoreAI, zanim jakikolwiek szczegół endpointu stanie się użyteczny.

**Deweloperzy narzędzi:** Myrspoven AI-API udostępnia wymianę danych i wartości zadanych przez HTTP. Dokumentacja OpenAPI jest źródłem nadrzędnym dla endpointów, schematów żądań/odpowiedzi oraz uwierzytelniania.

## Spis treści

### Myrspoven AI-API

Wyjaśnia interfejsy, przez które integruje się myCoreAI: autorski HTTP API Myrspoven, edge Myrspoven zapewniający łączność z lokalnym BMS oraz zewnętrzne API dostawców BMS/SCADA. Obejmuje uwierzytelnianie, środowiska, obsługę błędów i limity szybkości.

### odwołaniu OpenAPI

Maszynowo czytelna specyfikacja autorskiego Myrspoven AI-API — endpointy, parametry, schematy i uwierzytelnianie. To nadrzędne źródło szczegółów na poziomie endpointów; strona narracyjna zapewnia kontekst towarzyszący.

## Poza zakresem

* **Konfiguracja BMS i dostawców** (Schneider, Siemens, Web Port itp.) znajduje się w **rozdziale Integracje** rozdziale.
* **Instrukcje operacyjne** — dane uwierzytelniające VPN, utwardzanie serwera, procedury wdrażania — nie są publiczne i są obsługiwane bezpośrednio z Myrspoven.
* **Wewnętrzne narzędzia i potoki** — własny proces Myrspoven budowania, testowania i wdrażania — nie wchodzi w zakres dokumentacji dla partnerów.

## Konwencje

* Godziny są podawane w formacie ISO 8601 w UTC, chyba że zaznaczono inaczej.
* „Chmura Myrspoven” odnosi się do hostowanego backendu; „edge” odnosi się do komponentu lokalnego; „myCoreAI” odnosi się do agenta AI działającego w chmurze.
* Poświadczenia w przykładach są symboliczne. Działające poświadczenia są udostępniane bezpiecznym kanałem podczas integracji.
* W przypadku interfejsów API firm trzecich to dokumentacja dostawcy ma pierwszeństwo w odniesieniu do szczegółów na poziomie endpointów, jeśli nie zgadza się z tymi stronami.

## Uzyskiwanie pomocy

Błędy lub braki zgłaszaj 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 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/dokumentacja-dla-deweloperow/overview.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.
