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 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 pour le flux de travail dans l’application, et le référence de l'API 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.

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

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

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_<key>), 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, et le flux complet de gestion des clés se trouve dans Clés API.

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 — la voie d’intégration standard.

• API gRPC — la voie avancée / sur site (typée, de service à service).

• Serveur MCP — connectez votre propre client IA à votre organisation.

• Authentification et clés API — comment les requêtes sont autorisées.

• Exemples — une requête authentifiée minimale pour commencer.