> 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 utbyter data och börvärden med varje byggnad via ett av några gränssnitt — Myrspovens egen AI-API, en tredjepartsleverantörs API för BMS/SCADA, eller Myrspoven edge som körs lokalt. Den här sidan 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 [Kom igång med systemintegration](/myrspoven-docs/myrspoven-docs-sv/integrations/overview.md). ## Tillgängliga API-gränssnitt ### Myrspoven AI-API (egen) Myrspovenmolnet tillhandahåller ett eget HTTP-API för att utbyta byggnadsdata med myCoreAI — läsa aktuella värden och börvärden, upptäcka signaler, skriva börvärden och ladda upp signaldata. En connector på byggnadssidan integrerar 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 den auktoritativa källan för ändpunkter, begäran-/svarsmodeller 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 Desigo och Web Port. När ett sådant används integrerar myCoreAI via det API:et för att identifiera punkter, läsa realtids- och historiska värden samt skriva börvärden. API-gränssnittet — ändpunkter, scheman, parameterformat — ägs av leverantören, och **leverantörens dokumentation är den auktoritativa referensen**. Integrationsomfång, autentiseringsuppgifter och aktivering ordnas med Myrspoven under onboarding. ### Myrspoven edge (lokalt) Där det inte är möjligt att ansluta via en connector eller ett nåbart leverantörs-API körs Myrspoven edge i fastighetsägarens miljö, ansluter lokalt till BMS:et och utbyter data med Myrspovenmolnet. Edgen kommunicerar endast utgående — den hämtar de börvärden och uppgifter den behöver och skickar tillbaka värden och resultat — så inga inkommande brandväggsöppningar krävs på byggnadssidan. ## Autentisering och autentiseringsuppgifter Myrspoven AI-API använder OAuth2-bärartoken. 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 tredjepartsleverantörs-API kräver autentisering (vanligtvis ett servicekonto för skrivåtkomst) skapas autentiseringsuppgifterna på leverantörens sida och delas med Myrspoven via en säker kanal. Ändpunkter för endast läsning på vissa plattformar fungerar utan autentisering. Skrivningar kräver alltid ett dedikerat servicekonto. Nödvändiga scopes och behörigheter specificeras av Myrspoven per integration under onboarding. ## Miljöer Integrationer konfigureras per byggnad mot en enda produktionsmiljö. Ändringar som skulle påverka en byggnad i drift samordnas med Myrspoven, och det säkra sättet att testa är att pausa skrivningar för den byggnad som testas. ## Felhantering För Myrspovens egen AI-API dokumenteras svarskoder och felscheman i OpenAPI-referensen. För tredjepartsgränssnitt följer felhanteringen de konventioner som gäller hos leverantören som äger gränssnittet. När myCoreAI inte kan nå BMS:et slutar det skriva börvärden och BMS:et fortsätter att köras enligt sin egen logik — byggnaden fortsätter att fungera normalt; endast optimeringen pausas tills anslutningen återställs. ## Hastighetsbegränsningar Läs- och skrivfrekvensen avtalas per byggnad under uppstart. Läsningar körs vanligtvis var en till femte minut; skrivningar av börvärden körs med en fast frekvens — vanligtvis var 15:e minut — och går igenom det senaste optimeringsresultatet. När en tredjepartsleverantör inför sina egna hastighetsbegränsningar dokumenteras de av leverantören och justeras i samordning 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-sv/utvecklarreferens/myrspoven-ai-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.