API

La plupart des bâtiments se connectent à myCoreAI via leur système de gestion technique du bâtiment (BMS) ou la passerelle Myrspoven edge. Certains sites exposent plutôt des données — compteurs d’énergie, capteurs de climat intérieur, systèmes de présence — via une API de fournisseur. Cette page précise dans quels cas une intégration API s’applique, à quoi elle ressemble et où se trouve la référence complète.

Quand une intégration API s’applique

myCoreAI utilise une intégration API lorsque :

• Les données énergétiques proviennent d’une plateforme tierce (par exemple Mestro ou Metry) plutôt que du BMS.
• Les capteurs de climat intérieur sont gérés par une plateforme tierce qui expose une API cloud.
• Le BMS lui-même expose une API REST accessible sur le réseau, un point de terminaison OPC UA ou un SDK fournisseur que myCoreAI peut lire et auquel il peut écrire directement.

Rattacher les compteurs ou les capteurs au BMS est la voie la plus simple lorsque c’est possible — moins d’éléments mobiles, aucun coût de fournisseur tiers, une seule connexion à maintenir. Une intégration API est le bon choix lorsque les données ne se trouvent qu’en dehors du BMS, ou lorsque le BMS lui-même est l’API.

Structure d’une intégration API

Les trois cas partagent la même structure : Myrspoven détient les identifiants pour lire depuis l’API du fournisseur (et, le cas échéant, y écrire) selon un calendrier convenu. Une fois ingérés, les signaux sont traités de manière identique aux signaux BMS — le modèle de myCoreAI et les tableaux de bord myPortal sont indépendants du transport.

Les entrées fournies par le client sont également les mêmes d’un fournisseur à l’autre :

• Un compte ou une clé API avec un accès en lecture, et un accès en écriture lorsque myCoreAI doit renvoyer des consignes.
• Un mappage confirmé des ID de compteurs, des ID de capteurs ou des signaux vers les bâtiments et les zones.
• Un interlocuteur technique pour la mise en service.

Les identifiants exacts, les points de terminaison et les formats d’ID dépendent du fournisseur et sont documentés pour chaque bâtiment lors de l’étude technique.

Coût

Les plateformes tierces facturent généralement l’accès à l’API dans le cadre de leur propre contrat. Myrspoven ne facture pas séparément l’intégration. L’ajout d’un connecteur fournisseur qui n’est pas déjà pris en charge est évalué au cas par cas — faites-en la demande via Myrspoven.

Sécurité

Les identifiants API sont stockés dans le cloud de Myrspoven et utilisés uniquement pour l’intégration convenue. Le périmètre ne s’étend jamais au-delà des signaux de lecture/écriture configurés. Voir Sécurité.

Liés

• BMS — connexions directes au BMS, y compris les formes REST / OPC UA / BACnet.
• Données énergétiques — Mestro, Metry et import manuel.
• Climat intérieur — intégrations API avec des fournisseurs tiers de capteurs.
• Référence complète de l’API — voir la référence développeur.