> 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/docs-us-cs/integrace/api.md). # API Většina budov se připojuje k myCoreAI přes svůj systém správy budovy (BMS) nebo přes edge Myrspoven. Některá místa místo toho zpřístupňují data — energetické měřiče, senzory vnitřního klimatu, systémy obsazenosti — prostřednictvím API dodavatele. Tato stránka popisuje, kdy se uplatní integrace přes API, jak vypadá a kde najdete kompletní referenci. ## Kdy se uplatní integrace přes API myCoreAI používá integraci přes API, když: * Energetická data pocházejí z platformy třetí strany (například **Mestro** nebo **Metry**) namísto BMS. * Senzory vnitřního klimatu spravuje platforma třetí strany, která poskytuje cloudové API. * Samotný BMS poskytuje síťově dostupné rozhraní REST API, koncový bod OPC UA nebo SDK dodavatele, ze kterého může myCoreAI přímo číst i do něj zapisovat. Přesun měřičů nebo senzorů do BMS je, je-li to možné, jednodušší cesta — méně pohyblivých částí, žádné náklady na poskytovatele třetí strany, jedna konektivita k údržbě. Integrace přes API je správná volba, když data existují pouze mimo BMS, nebo když je samotný BMS tím API. ## Podoba integrace přes API Ve všech třech případech je podoba stejná: Myrspoven drží přihlašovací údaje pro čtení z API dodavatele (a tam, kde je to relevantní, i pro zápis do něj) podle dohodnutého plánu. Jakmile jsou signály ingestovány, zachází se s nimi identicky jako se signály z BMS — model myCoreAI i dashboardy myPortal jsou nezávislé na použitém přenosu. Vstupy poskytnuté zákazníkem jsou také konzistentní napříč dodavateli: * Účet nebo API klíč s přístupem pro čtení a tam, kde myCoreAI musí vracet nastavené hodnoty zpět, i s přístupem pro zápis. * Potvrzené přiřazení ID měřičů, ID senzorů nebo signálů k budovám a zónám. * Technický kontakt pro zprovoznění. Přesné přihlašovací údaje, koncové body a formáty ID jsou specifické pro daného dodavatele a jsou dokumentovány pro každou budovu během technického průzkumu. ## Cena Platformy třetích stran si za přístup k API obvykle účtují poplatky v rámci vlastní smlouvy. Myrspoven si za integraci neúčtuje zvláštní poplatek. Přidání konektoru pro dodavatele, který již není podporován, se posuzuje případ od případu — požádejte o něj prostřednictvím Myrspoven. ## Bezpečnost Přihlašovací údaje k API jsou uloženy v cloudu Myrspoven a používají se pouze pro dohodnutou integraci. Rozsah se nikdy nerozšiřuje nad nakonfigurované signály pro čtení/zápis. Viz [Bezpečnost](/myrspoven-docs/docs-us-cs/duvera-a-zabezpeceni/overview.md). ## Související * [Integrace BMS](/myrspoven-docs/docs-us-cs/integrace/overview/bms-integrations.md): přímá připojení k BMS, včetně REST, OPC UA a BACnetu. * [Energetická data](/myrspoven-docs/docs-us-cs/integrace/overview/energy-data.md): Mestro, Metry a ruční nahrávání. * Senzory vnitřního klimatu: platformy senzorů třetích stran jsou uvedeny v [Přehled integrací](/myrspoven-docs/docs-us-cs/integrace/overview.md). * [Referenční příručka pro vývojáře](/myrspoven-docs/docs-us-cs/vyvojarska-reference/myrspoven-ai-api.md): úplná referenční dokumentace 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/docs-us-cs/integrace/api.md?ask=&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.