API

De flesta byggnader ansluter till myCoreAI via sitt Building Management System (BMS) eller Myrspoven edge. Vissa anläggningar exponerar i stället data — energimätare, inomhusklimatsensorer, beläggningssystem — via ett leverantörs-API. Den här sidan beskriver när en API-integration är aktuell, hur den är uppbyggd och var hela referensen finns.

När en API-integration är aktuell

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

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

Att föra in mätare eller sensorer i BMS:et är den enklare vägen när det går — färre rörliga delar, ingen kostnad för tredje part-leverantör, en anslutning att underhålla. En API-integration är rätt val när datan bara finns utanför BMS:et, eller när BMS:et i sig är API:et.

Upplägg för en API-integration

Alla tre fall har samma upplägg: Myrspoven har åtkomstuppgifter 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 väl har importerats behandlas de på samma sätt som BMS-signaler — myCoreAI:s modell och myPortal-panelerna är transportoberoende.

De indata som kunden tillhandahåller är också konsekventa mellan leverantörer:

• Ett konto eller en API-nyckel med läsbehörighet, och skrivrättighet där myCoreAI måste 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ättningen.

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

Kostnad

Plattformar från tredje part 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örskopplare som inte redan stöds bedöms från fall till fall — begär en via Myrspoven.

Säkerhet

API-åtkomstuppgifter lagras i Myrspovens moln och används endast för den överenskomna integrationen. Omfattningen utökas aldrig utöver de konfigurerade läs-/skrivsignalerna. Se Säkerhet.

Relaterat

• BMS — direkta BMS-anslutningar, inklusive REST / OPC UA / BACnet-strukturer.
• Energidata — Mestro, Metry och manuell uppladdning.
• Inomhusklimat — API-integrationer med sensorleverantörer från tredje part.
• Fullständig API-referens — se Utvecklarreferens.