Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les développeurs d’API de votre organisation peuvent découvrir et consommer des API dans votre centre API à l’aide de l’extension Centre API Azure pour Visual Studio Code. L’extension offre les fonctionnalités suivantes :
Découvrir les API : parcourez les API dans votre centre API et examinez-en les détails et la documentation.
Consommer des API : générez des clients SDK d’API dans leur langage de prédilection, par exemple JavaScript, TypeScript, .NET, Python ou Java, en utilisant le moteur Microsoft Kiota qui génère des kits SDK pour Microsoft Graph, GitHub, etc.
Les développeurs d’API peuvent également tirer parti des fonctionnalités de l’extension pour inscrire des API dans le centre API pour garantir la gouvernance des API.
Conseil
Si vous souhaitez que les développeurs d’applications d’entreprise découvrent vos API dans un emplacement centralisé, activez éventuellement la vue portail du Centre d’API en lecture seule dans Visual Studio Code.
Prérequis
Un ou plusieurs centres d’API dans votre abonnement Azure. Vous pouvez créer un centre d’API à l’aide de l’extension du Centre d’API Azure ou d’autres outils.
- Actuellement, vous devez disposer du rôle de Contributeur au service Centre API d’Azure ou d’autorisations supérieures sur un centre API pour gérer des API avec l’extension.
- Extension du client REST : pour envoyer des requêtes HTTP et voir directement les réponses dans Visual Studio Code
- Extension Microsoft Kiota : pour générer des clients d’API
- Kit de ressources Microsoft 365 Agents - pour créer des agents déclaratifs Microsoft 365
Configuration de l’extension
Installez l’extension Centre API Azure pour Visual Studio Code à partir de la Place de marché Visual Studio Code. Installez d’autres extensions, le cas échéant.
Remarque
Lorsque cela est indiqué, certaines fonctionnalités sont disponibles uniquement dans la préversion de l’extension Azure API Center. Lors de l’installation de l’extension à partir de la Place de marché Visual Studio Code, vous pouvez choisir d’installer la version de mise en production ou une version préliminaire. Basculez entre les deux versions à tout moment à l’aide du menu contextuel Gérer du bouton Gérer de l’extension, dans la vue Extensions.
Dans Visual Studio Code, dans la barre d’activités à gauche, sélectionnez API Center (Centre API).
Si vous n’êtes pas connecté à votre compte Azure, sélectionnez Sign in to Azure... (Se connecter à Azure), puis suivez les invites pour vous connecter. Sélectionnez un abonnement Azure avec le ou les centres API à partir desquels vous souhaitez afficher des API. Vous pouvez également filtrer sur des abonnements spécifiques si vous en avez un grand nombre à voir.
API de découverte
Les ressources du centre API apparaissent dans l’arborescence à gauche. Développez une ressource du centre API pour afficher les API, les versions, les définitions, les environnements et les déploiements.
Recherchez des API dans un Centre d’API à l’aide de l’icône de recherche affichée dans l’élément d’arborescence des API .
Consulter la documentation d’API
Vous pouvez consulter la documentation relative à une définition d’API dans votre centre API et essayer des opérations d’API. Cette fonctionnalité n’est disponible que pour les API OpenAPI de votre centre API.
Développez l’arborescence Centre API pour afficher une définition d’API.
Cliquez avec le bouton droit sur la définition, puis sélectionnez Open API Documentation (Ouvrir la documentation d’API). Un nouvel onglet s’affiche avec l’interface utilisateur Swagger pour la définition d’API.
Pour essayer l’API, sélectionnez un point de terminaison, sélectionnez Try it out (Essayer), entrez les paramètres obligatoires, puis sélectionnez Execute (Exécuter).
Remarque
Selon l’API, vous serez peut-être amené à fournir des informations d’identification d’autorisation ou une clé API pour pouvoir essayer l’API.
Conseil
Vous pouvez générer la documentation de l’API dans Markdown, un format facile à gérer et à partager avec les utilisateurs finaux. Cliquez avec le bouton droit sur la définition, puis sélectionnez Générer Markdown.
Générer un fichier HTTP
Vous pouvez afficher un fichier .http basé sur la définition d’API dans votre centre API. Si l’extension Client REST est installée, vous pouvez effectuer des requêtes directement à partir de l’éditeur Visual Studio Code. Cette fonctionnalité n’est disponible que pour les API OpenAPI de votre centre API.
Développez l’arborescence Centre API pour afficher une définition d’API.
Cliquez avec le bouton droit sur la définition, puis sélectionnez Generate HTTP File (Générer un fichier HTTP). Un nouvel onglet s’affiche avec un document .http rempli par la spécification d’API.
Pour effectuer une requête, sélectionnez un point de terminaison, puis sélectionnez Send Request (Envoyer la requête).
Remarque
Selon l’API, vous serez peut-être amené à fournir des informations d’identification d’autorisation ou une clé API pour pouvoir effectuer la requête.
Générer un client d’API
Utilisez l’extension Microsoft Kiota pour générer un client d’API pour votre langage préféré. Cette fonctionnalité n’est disponible que pour les API OpenAPI de votre centre API.
- Développez l’arborescence Centre API pour afficher une définition d’API.
- Cliquez avec le bouton droit sur la définition, puis sélectionnez Generate API Client (Générer un client d’API). Le volet Kiota OpenAPI Generator s’affiche.
- Sélectionnez les points de terminaison d’API et les opérations HTTP que vous souhaitez inclure dans vos kits SDK.
- Sélectionnez Generate API client (Générer un client d’API).
Entrez des détails de configuration à propos du nom, de l’espace de noms et du répertoire de sortie du kit SDK.
Sélectionnez le langage pour le SDK généré.
Le client est généré.
Pour plus d’informations sur l’utilisation de l’extension Kiota, consultez Extension Microsoft Kiota pour Visual Studio Code.
Exporter une spécification d’API
Vous pouvez exporter une spécification d’API à partir d’une définition, puis la télécharger en tant que fichier.
Pour exporter une spécification dans l’arborescence de l’extension :
Développez l’arborescence Centre API pour afficher une définition d’API.
Cliquez avec le bouton droit sur la définition, puis sélectionnez Exporter le document de spécification d’API. Un nouvel onglet apparaît pour afficher un document de spécification d’API.
Vous pouvez également exporter une spécification à l’aide de la palette de commandes :
- Tapez le raccourci clavier Ctrl+Maj+P pour ouvrir la palette de commandes.
- Sélectionnez Centre API d’Azure : Exporter le document de spécification d’API.
- Faites des sélections pour accéder à une définition d’API. Un nouvel onglet apparaît pour afficher un document de spécification d’API.
Créer un agent déclaratif M365
Vous pouvez créer un agent déclaratif pour Microsoft 365 Copilot à partir d’une définition OpenAPI dans votre centre d’API. Avec un agent déclaratif, vous personnalisez Microsoft 365 Copilot pour vous aider à répondre aux besoins uniques de vos utilisateurs. Lorsque vous créez un agent déclaratif, vous fournissez les instructions, les actions et les connaissances nécessaires pour adapter Copilot à vos scénarios d’entreprise.
Pour exporter un agent déclaratif dans l’arborescence de l’extension :
- Développez l’arborescence du Centre d’API pour afficher une définition OpenAPI.
- Cliquez avec le bouton droit sur la définition, puis sélectionnez Exporter l’agent déclaratif M365.
- Lorsque vous y êtes invité :
- Sélectionnez une ou plusieurs opérations d’API avec lesquelles Copilot peut interagir.
- Sélectionnez un dossier d’espace de travail.
- Entrez un nom d’application.
L’agent déclaratif est créé dans le dossier d’espace de travail sélectionné. Utilisez microsoft 365 Agents Toolkit pour personnaliser et déployer davantage l’agent.