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.

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.