> 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-sv/referens-for-utvecklare/myrspoven-ai-api.md). # Myrspoven AI-API myCoreAI utbyter data och börvärden med varje byggnad via ett av några få gränssnitt — Myrspovens förstaparts AI-API, ett tredjeparts-API från en BMS/SCADA-leverantör, eller Myrspoven edge som körs lokalt. Denna sida beskriver varje gränssnitt och hänvisar till leverantörsdokumentation där en tredje part äger API:et. För den konceptuella dataflödesmodellen, se [Integrationsöversikt](/myrspoven-docs/myrspoven-docs-sv/integrationer/overview.md). ## Tillgängliga API-gränssnitt ### Myrspoven AI-API (förstaparts) Myrspovens moln exponerar ett förstaparts HTTP-API för utbyte av byggnadsdata med myCoreAI — läsning av aktuella värden och börvärden, upptäckt av signaler, skrivning av börvärden och uppladdning av signaldata. En connector på byggnadssidan integreras genom att anropa detta API; till exempel använder SmartConnector som körs i Schneider EcoStruxure Building Operation (EBO) det för att läsa optimerade börvärden och skicka tillbaka byggnadsvärden. API:et dokumenteras i **OpenAPI-referensen** i detta avsnitt, som är auktoritativ för endpoints, begär-/svarsscheman och autentisering. ### Tredjeparts-API:er för BMS/SCADA Vissa BMS- och SCADA-plattformar exponerar sitt eget HTTP- eller leverantörs-API — till exempel Siemens Building X och Web Port. När ett sådant används integreras myCoreAI via det API:et för att upptäcka punkter, läsa realtids- och historiska värden samt skriva börvärden. API-gränssnittet — endpoints, scheman, parameterformat — ägs av leverantören, och **leverantörens dokumentation är den auktoritativa referensen**. Integrationsomfattning, inloggningsuppgifter och aktivering ordnas med Myrspoven under onboarding. ### Myrspoven edge (lokalt) När det inte är möjligt att ansluta via en connector eller ett åtkomligt leverantörs-API körs Myrspoven edge i fastighetsägarens miljö, ansluter till BMS lokalt och utbyter data med Myrspovens moln. Edge-komponenten kommunicerar endast utgående — den hämtar de börvärden och de uppgifter den behöver och skickar tillbaka värden och resultat — så inga inkommande brandväggsöppningar krävs på byggnadssidan. ## Autentisering och inloggningsuppgifter Myrspoven AI-API använder OAuth2-bearer-token. Ett klient-ID och en hemlighet utfärdas av Myrspoven och delas via en säker kanal — aldrig via e-post eller chatt. OpenAPI-referensen dokumenterar tokenflödet. När ett tredjeparts-API kräver autentisering (vanligtvis ett servicekonto för skrivåtkomst) skapas inloggningsuppgifterna på leverantörens sida och delas med Myrspoven via en säker kanal. Vissa leverantörsplattformar tillåter skrivskyddad åtkomst utan autentisering; det är leverantörens inställning. Skrivningar kräver alltid ett dedikerat servicekonto. De scopes och behörigheter som krävs anges av Myrspoven per integration under onboarding. ## Miljöer Integrationer konfigureras per byggnad mot en enda produktionsmiljö. Ändringar som skulle påverka en live-byggnad samordnas med Myrspoven, och det säkra sättet att testa är att pausa skrivningar för byggnaden som testas. ## Felhantering För Myrspovens förstaparts AI-API dokumenteras svars-koder och felscheman i OpenAPI-referensen. För tredjepartsgränssnitt följer felhanteringen konventionerna hos den leverantör som äger gränssnittet. När myCoreAI inte kan nå BMS stoppar det skrivning av börvärden och BMS fortsätter att köra på sin egen logik — byggnaden fortsätter att fungera normalt; endast optimeringen pausas tills anslutningen återställs. ## Anropsbegränsningar Läs- och skrivfrekvensen överenskoms per byggnad under uppstart. Samma schema gäller när byggnaden ansluter via Myrspoven edge; edge-komponenten hämtar förfallna uppgifter från Myrspovens moln och har inga egna intervaller. Läsningar körs som standard var 15:e minut för de flesta integrationer, och var 12:e minut för Web Port. Skrivningar av börvärden körs var 15:e minut och går igenom det senaste optimeringsresultatet. Där en tredjepartsleverantör inför egna anropsbegränsningar dokumenteras de av leverantören och justeras i samarbete med Myrspoven. ## Få hjälp För integrationsbehov utöver de gränssnitt som beskrivs här, kontakta Myrspoven direkt. --- # 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-sv/referens-for-utvecklare/myrspoven-ai-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.