> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-fr/kilo-iot-server/api.md). # API Présentation de l’API Kilo IoT Server — accès REST et gRPC, clés à portée limitée et points de terminaison d’intégration cloud ou sur site. La plateforme Kilo IoT expose un accès programmatique afin que des systèmes externes puissent lire et gérer les données et la configuration de votre déploiement — et désormais envoyer des commandes à vos appareils — couvrant les intégrations backend, les pipelines d’analytique et de reporting, les outils industriels et d’automatisation, ainsi que les applications personnalisées. Utilisez le [**référence de l'API**](https://api.kiloiot.io/) pour la liste complète des points de terminaison, des champs de requête, des réponses et des scopes requis. Cette section explique à quoi sert l’API, comment choisir un protocole, comment les requêtes s’authentifient et où gérer les clés. > Le contrôle des appareils fait partie de l’API : une clé avec le **Commandes** scope peut créer des commandes d’un appareil et les diffuser sous forme de downlinks (marche/arrêt, consignes, et autres). Voir [Commandes de l’appareil](/kilo-docs-fr/kilo-iot-server/devices/commands.md) pour le flux de travail dans l’application, et le [référence de l'API](https://api.kiloiot.io/#tag/commands) pour les points de terminaison des commandes. ## Ce qui est disponible Deux protocoles sont proposés sur le même point de terminaison sécurisé : * **REST** — la voie principale pour la plupart des intégrations. HTTPS et JSON standards, utilisables depuis n’importe quel client HTTP. Commencez ici sauf raison particulière de faire autrement. Voir [API REST publique](/kilo-docs-fr/kilo-iot-server/api/public-rest-api.md). * **gRPC** — la voie avancée / sur site. Choisissez REST sauf si vous avez spécifiquement besoin de gRPC pour une intégration de service à service sur site ou typée. Voir [API gRPC](/kilo-docs-fr/kilo-iot-server/api/grpc-api.md). À côté d’eux, un point de terminaison distinct sert des clients IA plutôt que le code que vous écrivez : * **MCP** — connectez un client IA compatible MCP, comme Claude Code ou Claude Desktop, à votre organisation. Vous l’autorisez dans le navigateur avec votre compte Kilo habituel au lieu d’émettre une clé, et il fonctionne dans le cadre de vos propres autorisations. Voir [Serveur MCP](/kilo-docs-fr/kilo-iot-server/api/mcp-server.md). ## Authentification Les requêtes sont authentifiées à l’aide d’une clé API à portée définie dans le `X-API-Key` en-tête (format `kilo_`), plus votre contexte d’organisation dans `X-Organization-Id`. Les clés sont créées et gérées dans **Paramètres → Clés API**; les concepts sont résumés dans [Authentification et clés API](/kilo-docs-fr/kilo-iot-server/api/authentication-and-api-keys.md), et le flux complet de gestion des clés se trouve dans [Clés API](/kilo-docs-fr/kilo-iot-server/settings/api-keys.md). ## Cloud et sur site Les déploiements cloud utilisent le point de terminaison géré ci-dessus. Les installations sur site exposent la même API au sein de votre propre périmètre réseau, où gRPC convient naturellement à l’automatisation interne de service à service — mais REST reste disponible et demeure l’endroit le plus simple pour commencer. ## Dans cette section * [API REST publique](/kilo-docs-fr/kilo-iot-server/api/public-rest-api.md) — la voie d’intégration standard. * [API gRPC](/kilo-docs-fr/kilo-iot-server/api/grpc-api.md) — la voie avancée / sur site (typée, de service à service). * [Serveur MCP](/kilo-docs-fr/kilo-iot-server/api/mcp-server.md) — connectez votre propre client IA à votre organisation. * [Authentification et clés API](/kilo-docs-fr/kilo-iot-server/api/authentication-and-api-keys.md) — comment les requêtes sont autorisées. * [Exemples](/kilo-docs-fr/kilo-iot-server/api/examples.md) — une requête authentifiée minimale pour commencer. --- # 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.kiloiot.io/kilo-docs-fr/kilo-iot-server/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.