> 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-fr/integrations/api.md). # API La plupart des bâtiments se connectent à myCoreAI via leur système de gestion technique du bâtiment (BMS) ou le Myrspoven edge. Certains sites exposent plutôt des données — compteurs d'énergie, capteurs de climat intérieur, systèmes d'occupation — via une API fournisseur. Cette page explique dans quels cas une intégration API s'applique, sa structure, 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 d'énergie 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 écrire directement. Rattacher les compteurs ou capteurs au BMS est la voie la plus simple lorsque c'est possible — moins d'éléments, pas de 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 exactement comme des signaux BMS — le modèle de myCoreAI et les tableaux de bord myPortal sont agnostiques au transport. Les entrées fournies par le client sont également cohérentes d'un fournisseur à l'autre : * Un compte ou une clé API avec accès en lecture, et un accès en écriture lorsque myCoreAI doit renvoyer des consignes. * Un mappage confirmé des ID de compteur, ID de capteur ou signaux vers les bâtiments et les zones. * Un interlocuteur technique pour la mise en service. Les identifiants exacts, points de terminaison et formats d'ID dépendent du fournisseur et sont documentés par 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é](/myrspoven-docs/myrspoven-docs-fr/confiance-et-securite/overview.md). ## Connexe * BMS — connexions BMS directes, y compris les formats REST / OPC UA / BACnet. * Données d'énergie — Mestro, Metry et importation manuelle. * Climat intérieur — intégrations API de fournisseurs tiers de capteurs. * Référence API complète — voir le [Référence développeur](/myrspoven-docs/myrspoven-docs-fr/reference-developpeur/myrspoven-ai-api.md) (chapitre 7). --- # 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: ``` GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-fr/integrations/api.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.