Remarque : Cet article est technique, nous vous recommandons donc de faire intervenir quelqu'un possédant l'expertise technique appropriée. Si vous avez des questions, contactez-nous à support@azumuta.com.
Notre API REST utilise des codes de réponse HTTP et des verbes standard. Lors d'une demande GET normale, les données sont renvoyées sous forme de réponses codées en JSON.
Authentification
L'API Azumuta utilise des clés API pour authentifier les demandes. Vous avez deux options :
En-tête (recommandé)
Envoyez la clé dans l'en-tête de demande X-API-Key.
Paramètre
Utilisez le paramètre de requête apiKey.
Créez et gérez les clés sous Gestion → Appareils → API. Voir Créer et gérer les clés API.
Toutes les demandes d'API doivent être effectuées sur HTTPS. Les appels effectués sur HTTP simple échoueront. Les demandes d'API sans authentification échoueront également.
Remarque : Vos clés API sont des informations sensibles qui ne doivent jamais être partagées avec quiconque en dehors de votre entreprise, et ne doivent jamais apparaître dans le code client du navigateur.
Accès à la documentation de l'API
L'API REST d'Azumuta est documentée dans nos docs API intégrés :
- Cliquez sur le point d'interrogation en haut à droite de votre écran (Aide).
- Cliquez sur Docs API.
Cela ouvre la référence interactive à /docs/api dans la Plateforme Azumuta. Vous pouvez y parcourir les points de terminaison des modules Azumuta et des extensions (à l'exception des Tableaux de bord).
Lorsque vous êtes authentifié, vous pouvez tester en direct les points de terminaison avec le bouton Essayer et voir le résultat dans votre Plateforme Azumuta.
Amorce IA de l'Espace de travail pour les développeurs
Si vous créez une intégration avec un assistant de codage IA, commencez par l'amorce adaptée à l'espace de travail plutôt que de coller le document OpenAPI complet dans votre base de connaissances.
L'authentification GET /api/v1/agents-azumuta.md renvoie un fichier markdown pour votre espace de travail qui inclut l'URL de base, les langues et les conventions d'API. Téléchargez-le à partir de l'introduction des docs API intégrés, ou demandez ce chemin avec votre clé API.
La spécification OpenAPI lisible par machine est disponible à /api/v1/spec.json et nécessite également votre clé API, ou via l'interface utilisateur Swagger dans les docs API.
MCP pour les assistants IA (BÊTA)
BÊTA : Azumuta MCP est actuellement en bêta et peut encore évoluer. Il est disponible sur opt-in seulement. Pour rejoindre la bêta ou poser des questions, contactez support@azumuta.com.
Le protocole de contexte de modèle (MCP) permet à votre assistant IA préféré de récupérer les données d'espace de travail autorisées via des outils sélectionnés en lecture seule. Il n'expose pas chaque opération REST. Suivez Connectez votre assistant IA à Azumuta pour la configuration, puis consultez Utilisez Azumuta MCP pour des exemples et des limitations.
Appeler l'API à partir d'intégrations côté serveur
Appellez l'API REST d'Azumuta à partir d'intégrations côté serveur seulement. Conservez la clé API sur votre serveur ou couche d'intégration - pas dans les navigateurs des opérateurs ou d'autres codes côté client.