> 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-pour-les-developpeurs/myrspoven-ai-api.md). # Myrspoven AI-API myCoreAI échange des données et des consignes avec chaque bâtiment via l’une de რამდენიმე interfaces — l’API Myrspoven AI-API propriétaire, une API de fournisseur BMS/SCADA tiers, ou le Myrspoven edge exécuté sur site. Cette page décrit chaque interface et renvoie vers la documentation du fournisseur lorsqu’un tiers est propriétaire de l’API. Pour le modèle conceptuel de flux de données, voir [Prise en main de l’intégration système](/myrspoven-docs/myrspoven-docs-fr/integrations/overview.md). ## Interfaces API disponibles ### Myrspoven AI-API (propriétaire) Le cloud Myrspoven expose une API HTTP propriétaire pour l’échange des données du bâtiment avec myCoreAI — lecture des valeurs et consignes actuelles, découverte des signaux, écriture des consignes et importation des données de signal. Un connecteur côté bâtiment s’intègre en appelant cette API ; par exemple, le SmartConnector exécuté dans Schneider EcoStruxure Building Operation (EBO) l’utilise pour lire les consignes optimisées et renvoyer les valeurs du bâtiment. L’API est documentée dans la **référence OpenAPI** de cette section, qui fait autorité pour les endpoints, les schémas de requête/réponse et l’authentification. ### API BMS/SCADA tierces Certaines plateformes BMS et SCADA exposent leur propre API HTTP ou API fournisseur — par exemple Siemens Desigo et Web Port. Lorsqu’une telle API est utilisée, myCoreAI s’intègre via cette API pour découvrir les points, lire les valeurs en temps réel et historiques, et écrire des consignes. L’interface API — endpoints, schémas, formats des paramètres — est détenue par le fournisseur, et **la documentation du fournisseur fait foi**. Le périmètre d’intégration, les identifiants et l’activation sont définis avec Myrspoven pendant l’onboarding. ### Myrspoven edge (sur site) Lorsque la connexion via un connecteur ou une API fournisseur accessible n’est pas viable, le Myrspoven edge s’exécute dans l’environnement du propriétaire du bâtiment, se connecte localement au BMS et échange des données avec le cloud Myrspoven. L’edge communique uniquement en sortie — il récupère les consignes et les tâches dont il a besoin et renvoie les valeurs et les résultats — donc aucune ouverture de pare-feu en entrée n’est requise côté bâtiment. ## Authentification et identifiants L’API Myrspoven AI-API utilise des jetons porteur OAuth2. Un identifiant client et un secret sont délivrés par Myrspoven et partagés via un canal sécurisé — jamais par e-mail ou chat. La référence OpenAPI documente le flux de jeton. Lorsqu’une API de fournisseur tiers exige une authentification (généralement un compte de service pour l’accès en écriture), les identifiants sont créés côté fournisseur et partagés avec Myrspoven via un canal sécurisé. Les endpoints en lecture seule sur certaines plateformes fonctionnent sans authentification. Les écritures nécessitent toujours un compte de service dédié. Les scopes et autorisations requis sont définis par Myrspoven pour chaque intégration pendant l’onboarding. ## Environnements Les intégrations sont configurées par bâtiment pour un seul environnement de production. Les changements susceptibles d’affecter un bâtiment en exploitation sont coordonnés avec Myrspoven, et la manière sûre de tester consiste à suspendre les écritures pour le bâtiment en test. ## Gestion des erreurs Pour l’API Myrspoven AI-API propriétaire, les codes de réponse et les schémas d’erreur sont documentés dans la référence OpenAPI. Pour les interfaces tierces, la gestion des erreurs suit les conventions du fournisseur propriétaire de l’interface. Lorsque myCoreAI ne peut pas atteindre le BMS, il cesse d’écrire les consignes et le BMS continue à fonctionner selon sa propre logique — le bâtiment continue de fonctionner normalement ; seule l’optimisation est mise en pause jusqu’au rétablissement de la connexion. ## Limites de débit La cadence de lecture et d’écriture est convenue par bâtiment lors du démarrage. Les lectures s’exécutent généralement toutes les une à cinq minutes ; les écritures de consignes s’exécutent selon une cadence fixe — généralement toutes les 15 minutes — en appliquant la dernière sortie d’optimisation. Lorsqu’un fournisseur tiers impose ses propres limites de débit, celles-ci sont documentées par le fournisseur et ajustées en coordination avec Myrspoven. ## Obtenir de l’aide Pour des besoins d’intégration allant au-delà des interfaces décrites ici, contactez 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, and the optional `goal` query parameter: ``` GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-fr/reference-pour-les-developpeurs/myrspoven-ai-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.