> 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/utvecklarreferens/myrspoven-ai-api.md). # Myrspoven AI-API myCoreAI integreras via Building Management System (BMS) — läser sensorvärden och skriver setpoints över de protokoll som BMS redan stöder (Modbus, BACnet, SmartConnector, CtAPI och andra). Den här sidan dokumenterar de API-gränssnitt som är relevanta för myCoreAI-integrationer, hänvisar till leverantörsdokumentation där en tredje part äger API:t, och klargör vad som inte är offentligt tillgängligt. För den konceptuella dataflödesmodellen, se [Komma igång med systemintegration](/myrspoven-docs/myrspoven-docs-sv/integrationer/overview.md). ## Tillgängliga API-gränssnitt ### BMS-protokoll I nästan varje byggnad integreras myCoreAI via standardiserade BMS-protokoll snarare än via ett HTTP-API. Myrspovens edge-komponent, som är placerad i fastighetsägarens miljö, hämtar aktuella värden från BMS:et och skriver tillbaka beräknade setpoints. Edge-komponenten gör utgående polling mot Myrspoven-molnet. Inga inkommande brandväggsöppningar krävs på byggnadens sida. ### Larmia EVO SCADA Open API (tredjepart) När BMS:et är Larmia EVO SCADA integrerar myCoreAI via Larmias Open REST API för att hitta punkter, läsa historik och realtidsvärden samt skriva överskrivningar av setpoints. API-gränssnittet — endpoints, scheman, parameterformat — ägs av Larmia. **Larmias officiella dokumentation** är den auktoritativa referensen. För integrationsomfattning och aktivering på Larmias sida, se [integrationen med Larmia EVO SCADA](broken://pages/7b5be69626c3c387395c4889141f7321ba425d4c) sidan. ### Andra BMS-API:er Ett fåtal BMS-plattformar exponerar egna HTTP- eller leverantörs-API:er (till exempel Schneiders SmartConnector och Citects CtAPI). I de fallen ägs API:t av BMS-leverantören och leverantörens dokumentation gäller. Åtkomst samordnas med Myrspoven under onboarding. ## Autentisering och inloggningsuppgifter När ett leverantörs-API kräver autentisering (vanligtvis ett servicekonto för skrivåtkomst) skapas inloggningsuppgifter på leverantörssidan och delas med Myrspoven via en säker kanal — aldrig via e-post eller chatt. Endpoints med endast läsbehörighet på vissa plattformar (inklusive Larmia EVO SCADA) fungerar utan autentisering. Skrivåtkomst kräver alltid ett dedikerat servicekonto. Nödvändiga scopes och behörigheter är specifika för varje BMS; Myrspoven anger dem per integration under onboarding. ## Miljöer Integrationer konfigureras per byggnad mot en enda produktionsmiljö. Myrspoven publicerar ingen separat sandbox- eller staging-API. Ändringar som skulle påverka en live-byggnad samordnas med Myrspoven; det säkrare alternativet är att pausa skrivningar för byggnaden som testas i stället för att sätta upp en parallell miljö. ## Felhantering Felhanteringen följer konventionerna hos den leverantör som äger gränssnittet (Larmia, Schneider osv.). För BMS-protokollsbanan definieras felsemantiken av protokollet — Modbus-exceptionskoder, BACnet-felkategorier och så vidare. Om myCoreAI inte kan nå BMS:et slutar det skriva setpoints och BMS:et fortsätter att köra på sin egen logik. Byggnaden fortsätter att fungera normalt; endast optimeringen pausas tills anslutningen återställs. ## Anropsgränser Pollingfrekvensen avtalas per byggnad under uppstarten. Typiska läsningar körs varje minut till var några minuter; skrivningar körs med en fast frekvens — vanligtvis varje timme — när en ny optimeringskörning har slutförts. Leverantörsdefinierade anropsgränser dokumenteras av leverantören och justeras i samordning med Myrspoven så att läs- och skrivfrekvenserna ligger i linje med styrloopen. ## Inte tillgängligt för närvarande * **Ingen allmän Myrspoven REST API för kunder eller partners.** Rapportering, signalhantering och manuell datauppladdning sker via myPortal. * **Inget publicerat webhook-gränssnitt.** myCoreAI skickar inte händelser till kundsystem via HTTPS-callbacks. * **Inget publicerat SDK eller klientbibliotek.** Integrationsbehov som skulle kräva något av ovanstående bör tas upp direkt med 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 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-sv/utvecklarreferens/myrspoven-ai-api.md?ask= ``` 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.