> 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 via la périphérie Myrspoven. 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 quand une intégration API s’applique, son format 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 écrire directement. Rattacher les compteurs ou les capteurs au BMS est la solution la plus simple lorsque c’est possible — moins d’éléments mobiles, aucun coût lié à un fournisseur tiers, une seule connexion à maintenir. Une intégration API est le bon choix lorsque les données ne résident qu’en dehors du BMS, ou lorsque le BMS lui-même est l’API. ## Format d’une intégration API Les trois cas ont la même structure : Myrspoven détient les identifiants pour lire 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 éléments d’entrée fournis par le client sont également cohérents d’un fournisseur à l’autre : * Un compte ou une clé API avec accès en lecture, et 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 sont spécifiques au fournisseur et 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 une 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). ## À lire aussi * [Intégrations BMS](/myrspoven-docs/myrspoven-docs-fr/integrations/overview/bms-integrations.md): connexions BMS directes, y compris REST, OPC UA et BACnet. * [Données d’énergie](/myrspoven-docs/myrspoven-docs-fr/integrations/overview/energy-data.md): Mestro, Metry et import manuel. * Capteurs de climat intérieur : les plateformes de capteurs tierces sont répertoriées dans le [aperçu des intégrations](/myrspoven-docs/myrspoven-docs-fr/integrations/overview.md). * [Référence développeur](/myrspoven-docs/myrspoven-docs-fr/reference-developpeur/myrspoven-ai-api.md): la référence complète de l’API. --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.