> 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/anslut-din-byggnad/api.md).

# API

De flesta byggnader ansluter till myCoreAI via sitt fastighetsautomationssystem (BMS) eller Myrspovens edge-lösning. Vissa anläggningar exponerar i stället data – energimätare, sensorer för inomhusklimat och system för beläggning – via ett leverantörs-API. Den här sidan beskriver när en API-integration är aktuell, hur den fungerar och var du hittar den fullständiga referensdokumentationen.

## När en API-integration är aktuell

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

* Energidata kommer från en tredjepartsplattform (till exempel **Mestro** eller **Metry**) i stället för från BMS-systemet.
* Sensorerna för inomhusklimat tillhör en tredjepartsplattform som tillhandahåller ett moln-API.
* Själva BMS-systemet tillhandahåller ett nätverkstillgängligt REST-API, en OPC UA-slutpunkt eller ett leverantörs-SDK som myCoreAI kan läsa från och skriva till direkt.

När det är möjligt är det enklare att ansluta mätare eller sensorer till BMS-systemet – färre komponenter, inga kostnader för en tredjepartsleverantör och bara en anslutning att underhålla. En API-integration är rätt val när data bara finns utanför BMS-systemet eller när BMS-systemet självt är API:et.

## Så fungerar en API-integration

Alla tre fallen fungerar på samma sätt: Myrspoven har inloggningsuppgifter för att läsa från (och vid behov skriva till) leverantörens API enligt ett överenskommet schema. När signalerna har hämtats in behandlas de på samma sätt som BMS-signaler – myCoreAI:s modell och myPortal-instrumentpanelerna är oberoende av överföringssätt.

Kunden behöver tillhandahålla följande, oavsett leverantör:

* Ett konto eller en API-nyckel med läsbehörighet och, när myCoreAI behöver skicka tillbaka börvärden, skrivbehörighet.
* En bekräftad mappning av mätar-ID:n, sensor-ID:n eller signaler till byggnader och zoner.
* En teknisk kontaktperson för driftsättningen.

Exakta inloggningsuppgifter, slutpunkter och ID-format varierar mellan leverantörer och dokumenteras för varje byggnad under den tekniska genomgången.

## Kostnad

Tredjepartsplattformar tar vanligtvis ut en avgift för API-åtkomst enligt sina egna avtal. Myrspoven tar inte ut någon separat avgift för integrationen. Om en leverantörsanslutning som ännu inte stöds ska läggas till utvärderas detta från fall till fall – kontakta Myrspoven för att begära en sådan.

## Säkerhet

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

## Relaterat

* [BMS-integrationer](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-sv/anslut-din-byggnad/bms-integrations.md): direkta BMS-anslutningar, inklusive REST, OPC UA och BACnet.
* [Energidata](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-sv/anslut-din-byggnad/energy-data.md): Mestro, Metry och manuell uppladdning.
* Sensorer för inomhusklimat: tredjepartsplattformarna för sensorer finns listade i [Översikt över integrationer](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-sv/anslut-din-byggnad/overview.md).
* [Utvecklare](https://docs.myrspoven.com/developers): Myrspovens egna API:er för partner, tillgängliga enligt överenskommelse.


---

# 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/anslut-din-byggnad/api.md?ask=<question>&goal=<user_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.
