> 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/integrations/api.md).

# API

De flesta byggnader ansluter till myCoreAI via sitt byggnadsautomationssystem (BMS) eller Myrspovens edge. Vissa anläggningar exponerar i stället data — energimätare, inomhusklimatsensorer, närvarosystem — via ett leverantörs-API. Den här sidan beskriver när en API-integration är relevant, hur den är utformad och var hela referensen finns.

## När en API-integration är tillämplig

myCoreAI använder en API-integration när:

* Energiuppgifter kommer från en tredjepartsplattform (till exempel **Mestro** eller **Metry**) i stället för BMS.
* Inomhusklimatsensorer ägs av en tredjepartsplattform som exponerar ett moln-API.
* BMS:et självt exponerar ett nätverksåtkomligt REST-API, en OPC UA-slutpunkt eller ett leverantörs-SDK som myCoreAI kan läsa från och skriva till direkt.

Att flytta in mätare eller sensorer i BMS:et är den enklare vägen när det är möjligt — färre rörliga delar, ingen kostnad för tredjepartsleverantör, en anslutning att underhålla. En API-integration är rätt val när data bara finns utanför BMS:et, eller när BMS:et självt är API:et.

## Uppbyggnad av en API-integration

Alla tre fall har samma uppbyggnad: Myrspoven har uppgifter för att läsa från (och där det är relevant, skriva till) leverantörens API enligt ett överenskommet schema. När signalerna har matats in behandlas de identiskt med BMS-signaler — myCoreAIs modell och myPortal-instrumentpanelerna är transportagnostiska.

Kundtillhandahållna indata är också konsekventa mellan leverantörer:

* Ett konto eller API-nyckel med läsrättigheter, och skrivåtkomst där myCoreAI behöver skicka tillbaka börvärden.
* En bekräftad mappning av mätar-ID:n, sensor-ID:n eller signaler till byggnader och zoner.
* En teknisk kontaktperson för driftsättning.

Exakta uppgifter, slutpunkter och ID-format är leverantörsspecifika och dokumenteras per byggnad under den tekniska genomgången.

## Kostnad

Tredjepartsplattformar tar vanligtvis betalt för API-åtkomst enligt sitt eget avtal. Myrspoven tar inte ut någon separat avgift för integrationen. Att lägga till en leverantörskoppling som inte redan stöds bedöms från fall till fall — begär en via Myrspoven.

## Säkerhet

API-uppgifter lagras i Myrspovens moln och används endast för den överenskomna integrationen. Omfattningen utökas aldrig bortom de konfigurerade läs-/skrivsignalerna. Se [Säkerhet](/myrspoven-docs/myrspoven-docs-sv/tillit-och-sakerhet/overview.md).

## Relaterat

* BMS — direkta BMS-anslutningar, inklusive REST / OPC UA / BACnet-varianter.
* Energidata — Mestro, Metry och manuell uppladdning.
* Inomhusklimat — API-integrationer med sensortillverkare från tredje part.
* Fullständig API-referens — se [Utvecklarreferens](/myrspoven-docs/myrspoven-docs-sv/utvecklarreferens/myrspoven-ai-api.md).


---

# 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/integrations/api.md?ask=<question>&goal=<endgoal>
```

`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.