> 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/overview.md).

# Aperçu

Matériel de référence pour les développeurs et les intégrateurs système qui travaillent avec myCoreAI par programmation — connecter un bâtiment, échanger des données avec le cloud Myrspoven, ou créer des outils par-dessus une intégration existante.

La section comporte deux parties : une **page narrative** qui explique quelle surface d’intégration s’applique à un bâtiment et comment elle se comporte, ainsi que la **référence OpenAPI** qui documente l’API Myrspoven AI-API de première partie, point d’accès par point d’accès.

**Intégrateurs :** commencez par **Prise en main de l’intégration système** dans le chapitre Intégrations — cela explique comment l’edge, le cloud Myrspoven et myCoreAI s’articulent avant que le moindre détail d’endpoint ne devienne utile.

**Développeurs d’outils :** l’API Myrspoven AI-API expose l’échange de données et de consignes via HTTP. La référence OpenAPI fait autorité pour les endpoints, les schémas de requête/réponse et l’authentification.

## Contenu

### Myrspoven AI-API

Explique les surfaces sur lesquelles myCoreAI s’intègre : l’API HTTP Myrspoven de première partie, l’edge Myrspoven pour la connectivité BMS sur site, et les API BMS/SCADA de fournisseurs tiers. Couvre l’authentification, les environnements, la gestion des erreurs et les limites de débit.

### référence OpenAPI

La spécification lisible par machine de l’API Myrspoven AI-API de première partie — endpoints, paramètres, schémas et authentification. C’est la source faisant autorité pour les détails au niveau des endpoints ; la page narrative fournit le contexte environnant.

## Hors périmètre

* **La configuration BMS et fournisseur** (Schneider, Siemens, Web Port, etc.) se trouve dans le chapitre **Intégrations** .
* **Modes opératoires d’exploitation** — identifiants VPN, durcissement des serveurs, procédures de déploiement — ne sont pas publics et sont gérés directement avec Myrspoven.
* **Outils internes et pipelines** — le processus interne de Myrspoven pour la construction, les tests et le déploiement — n’entre pas dans le cadre de la documentation partenaire.

## Conventions

* Les heures sont au format ISO 8601 en UTC sauf indication contraire.
* « Le cloud Myrspoven » désigne le backend hébergé ; « l’edge » désigne le composant sur site ; « myCoreAI » désigne l’agent IA exécuté dans le cloud.
* Les identifiants dans les exemples sont des placeholders. Les identifiants fonctionnels sont partagés via un canal sécurisé pendant l’intégration.
* Pour les API tierces, la documentation du fournisseur prévaut pour les détails au niveau des endpoints lorsqu’elle est en désaccord avec ces pages.

## Obtenir de l’aide

Signalez les erreurs ou les lacunes à 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/overview.md?ask=<question>&goal=<endgoal>
```

`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.