REST API d'Azumuta
Note : Il s'agit d'un article très technique. Nous vous recommandons donc d'impliquer votre service informatique lors de sa lecture. Pour toute question ou demande, veuillez nous contacter via support@azumuta.com - nous serons heureux de vous aider.
Notre API REST utilise les codes de réponse et les verbes HTTP standard. Lors d'une requête GET normale, les données sont retournées au format JSON.
Authentication
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 Management → Devices → API. Voir Create and manage API keys.
Toutes les requêtes API doivent être effectuées via HTTPS. Les appels effectués 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 avec des personnes extérieures à votre entreprise, et ne doivent jamais apparaître dans du code client côté navigateur.
Access API documentation
L'API REST d'Azumuta est documentée dans notre documentation API intégrée :
- Cliquez sur le point d'interrogation en haut à droite de votre écran (Help).
- 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 plateforme Azumuta.
Workspace AI Primer for Developers
Si vous développez une intégration avec un assistant de codage IA, commencez par le primer adapté à votre workspace plutôt que de coller l'ensemble du document OpenAPI dans votre base de connaissances.
Un GET /api/v1/agents-azumuta.md authentifié renvoie un fichier markdown pour votre workspace (URL de base, langues et conventions 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 for AI assistants (beta)
Fonctionnalité bêta. Le serveur MCP (Model Context Protocol) d'Azumuta permet aux assistants IA d'appeler les outils REST autorisés pour votre espace de travail. Il est en bêta, peut encore évoluer, et n'est disponible que sur participation volontaire. Pour activer MCP ou poser des questions, contactez support@azumuta.com.
L'accès MCP nécessite l'expérience MCP du workspace et une clé API avec des scopes explicites. Préférez le workspace AI primer et la documentation API intégrée pour les conventions des endpoints ; ne collez pas l'ensemble du document OpenAPI dans une base de connaissances partagée.
Call the API from Server-Side Integrations
Appelez l'API Azumuta uniquement depuis des intégrations côté serveur. Gardez 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.