> 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/reference-developpeur/myrspoven-ai-api.md). # Myrspoven AI-API myCoreAI s’intègre via le système de gestion technique du bâtiment (BMS) — en lisant les valeurs des capteurs et en écrivant les points de consigne via les protocoles déjà pris en charge par le BMS (Modbus, BACnet, SmartConnector, CtAPI, et autres). Cette page documente les surfaces d’API pertinentes pour les intégrations myCoreAI, renvoie vers la documentation des éditeurs lorsqu’un tiers détient l’API, et précise clairement ce qui n’est pas publiquement disponible. Pour le modèle conceptuel de flux de données, voir [Premiers pas avec l’intégration système](/myrspoven-docs/myrspoven-docs-fr/integrations/overview.md). ## Surfaces d’API disponibles ### Protocoles BMS Dans presque tous les bâtiments, myCoreAI s’intègre via des protocoles BMS standard plutôt que via une API HTTP. Le composant edge Myrspoven, déployé dans l’environnement du propriétaire du bâtiment, interroge le BMS pour obtenir les valeurs réelles et réécrit les points de consigne calculés. Le composant edge interroge en sortie le cloud Myrspoven. Aucune ouverture entrante du pare-feu n’est requise côté bâtiment. ### Larmia EVO SCADA Open API (tiers) Lorsque le BMS est Larmia EVO SCADA, myCoreAI s’intègre via l’API REST ouverte de Larmia pour découvrir les points, lire l’historique et les valeurs en temps réel, et écrire des remplacements de consigne. La surface d’API — points de terminaison, schémas, formats des paramètres — appartient à Larmia. **La documentation officielle de Larmia** est la référence faisant autorité. Pour le périmètre d’intégration et l’activation côté Larmia, voir la [page d’intégration Larmia EVO SCADA](broken://pages/fa3fb386971721133d9325a74cde15b72ec906fd) . ### Autres API BMS Quelques plateformes BMS exposent leurs propres API HTTP ou API d’éditeur (par exemple SmartConnector de Schneider et CtAPI de Citect). Dans ces cas, l’API appartient à l’éditeur du BMS et la documentation de l’éditeur s’applique. L’accès est coordonné avec Myrspoven pendant l’onboarding. ## Authentification et identifiants Lorsqu’une API d’éditeur nécessite une authentification (généralement un compte de service pour l’accès en écriture), les identifiants sont créés côté éditeur et partagés avec Myrspoven via un canal sécurisé — jamais par e-mail ou par chat. Les points de terminaison en lecture seule sur certaines plateformes (y compris Larmia EVO SCADA) fonctionnent sans authentification. Les écritures nécessitent toujours un compte de service dédié. Les scopes et autorisations requis dépendent du BMS ; Myrspoven les précise pour chaque intégration pendant l’onboarding. ## Environnements Les intégrations sont configurées par bâtiment sur un seul environnement de production. Myrspoven ne publie pas d’API sandbox ou de préproduction distincte. Les changements qui affecteraient un bâtiment en production sont coordonnés avec Myrspoven ; la solution la plus sûre consiste à suspendre les écritures pour le bâtiment testé plutôt que de mettre en place un environnement parallèle. ## Gestion des erreurs La gestion des erreurs suit les conventions de l’éditeur propriétaire de la surface (Larmia, Schneider, etc.). Pour le chemin basé sur les protocoles BMS, la sémantique des erreurs est définie par le protocole — codes d’exception Modbus, classes d’erreur BACnet, et ainsi de suite. Si myCoreAI ne peut pas joindre le BMS, il cesse d’écrire les points de consigne et le BMS continue de fonctionner selon sa propre logique. Le bâtiment continue de fonctionner normalement ; seule l’optimisation est mise en pause jusqu’à ce que la connexion soit rétablie. ## Limites de débit La cadence de sondage est convenue par bâtiment lors du démarrage. Les lectures typiques s’effectuent toutes les minutes à toutes les quelques minutes ; les écritures s’effectuent selon une cadence fixe — généralement horaire — une fois qu’un nouveau cycle d’optimisation est terminé. Les limites de débit imposées par l’éditeur sont documentées par ce dernier et ajustées en coordination avec Myrspoven afin que les cadences de lecture et d’écriture restent alignées avec la boucle de contrôle. ## Non disponible actuellement * **Aucune API REST Myrspoven à usage général pour les clients ou partenaires.** Le reporting, la gestion des signaux et le téléversement manuel des données se font via myPortal. * **Aucune surface webhook publiée.** myCoreAI n’envoie pas d’événements aux systèmes clients via des callbacks HTTPS. * **Aucun SDK ni bibliothèque cliente publiés.** Les besoins d’intégration nécessitant l’un des éléments ci-dessus doivent être adressés directement à Myrspoven. --- # 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/reference-developpeur/myrspoven-ai-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.