API REST d'Azumuta
Note : Cet article est très technique. Nous vous recommandons donc d'impliquer votre service informatique lors de sa lecture. Pour toute question ou demande, contactez-nous via support@azumuta.com — nous serons ravis de vous aider.
Notre API REST utilise les codes de réponse HTTP standard et les verbes. Lors d'une requête GET classique, les données sont renvoyées encodées au format JSON.
Authentification
L'API Azumuta utilise des clés API pour authentifier les requêtes. Envoyez la clé dans l'en-tête de requête X-API-Key (recommandé). Vous pouvez aussi utiliser un paramètre de requête apiKey.
Créez et gérez les clés sous Gestion → Appareils → API. Voir Comment créer et gérer des clés API.
Toutes les requêtes API doivent être effectuées via HTTPS. Les appels en HTTP simple échoueront. Les requêtes API sans authentification échoueront également.
Note : Vos clés API sont des informations hautement confidentielles qui ne doivent jamais être partagées en dehors de votre entreprise et ne doivent jamais apparaître dans du code client exécuté dans un navigateur.
Comment accéder à la documentation de l'API
La documentation REST de l'API Azumuta se trouve dans la documentation API intégrée à l'application :
- Cliquez sur le point d'interrogation en haut à droite de votre écran (Aide).
- Cliquez sur API docs.
Cela ouvre la référence interactive à /docs/api dans la plateforme Azumuta. Vous pouvez y parcourir les endpoints des modules et add-ons Azumuta (sauf Dashboards).
Lorsque vous êtes authentifié, vous pouvez tester les endpoints en direct avec le bouton Try it out et voir le résultat dans votre Azumuta Platform.
Guide IA spécifique à l'espace de travail pour développeurs
Si vous développez une intégration avec un assistant de codage IA, commencez par le guide adapté à votre espace de travail plutôt que de coller l'intégralité du document OpenAPI dans votre base de connaissances.
Une requête authentifiée GET /api/v1/agents-azumuta.md renvoie un fichier markdown pour votre espace de travail (URL de base, langues et conventions d'API). Téléchargez-le depuis l'introduction de la documentation API intégrée, ou demandez ce chemin avec votre clé API.
La spécification OpenAPI lisible par machine est disponible à /api/v1/spec.json (requiert également votre clé API), ou via le Swagger UI dans la documentation API.
MCP pour assistants IA (bêta)
Fonctionnalité bêta. Le serveur MCP (Model Context Protocol) d'Azumuta permet aux assistants IA d'appeler des outils REST autorisés pour votre espace de travail. Il est en bêta, peut encore évoluer, et est disponible uniquement sur inscription. Pour activer MCP ou poser des questions, contactez support@azumuta.com.
L'accès MCP requiert l'expérience MCP pour l'espace de travail et une clé API avec des scopes explicites. Préférez le guide IA spécifique à l'espace de travail et la documentation API dans l'application pour les conventions d'endpoint ; ne collez pas l'intégralité du document OpenAPI dans une base de connaissances partagée.
Appeler l'API depuis des intégrations côté serveur
Appelez l'API REST d'Azumuta uniquement depuis des intégrations côté serveur. Conservez la clé API sur votre serveur ou couche d'intégration — pas dans les navigateurs des opérateurs ni dans tout autre code côté client.