> 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 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é](/myrspoven-docs/myrspoven-docs-fr/confiance-et-securite/overview.md). ## 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](/myrspoven-docs/myrspoven-docs-fr/reference-pour-les-developpeurs/myrspoven-ai-api.md). --- # 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, and the optional `goal` query parameter: ``` GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-fr/integrations/api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.