Importer une spécification OpenAPI

S’APPLIQUE À : tous les niveaux de Gestion des API

Cet article montre comment importer une API de serveur principal de « spécification OpenAPI » se trouvant à l’adresse https://conferenceapi.azurewebsites.net?format=json. Cette API de serveur principal est fournie par Microsoft et hébergée sur Azure. L’article explique également comment tester l’API APIM.

Dans cet article, vous apprendrez comment :

  • Importez une spécification OpenAPI à l’aide du Portail Azure, d’Azure CLI ou de Azure PowerShell.
  • Tester l’API dans le portail Azure

Notes

Les limitations d’importation d’API sont documentées dans les restrictions d’importation d’API et les problèmes connus.

Prérequis

Importer une API back-end

  1. Dans le portail Azure, accédez à votre instance APIM.

  2. Dans le menu de gauche, cliquez sur API > + Ajouter une API.

  3. Sous Créer à partir d’une définition, sélectionnez OpenAPI.

    Capture d’écran de la création d’une API à partir d’une spécification OpenAPI dans le portail

  4. Entrez les paramètres de l’API. Vous pouvez définir les valeurs lors de la création, ou les configurer ultérieurement en accédant à l’onglet Paramètres. Les paramètres sont expliqués dans le tutoriel Importer et publier votre première API.

  5. Sélectionnez Create (Créer).

Tester la nouvelle API dans le portail

Les opérations peuvent être appelées directement à partir du portail, ce qui permet d’afficher et de tester facilement les opérations d’une API.

  1. Sélectionnez l’API que vous avez créée à l’étape précédente.

  2. Sélectionnez l’onglet Test.

  3. Sélectionnez une opération. La page affiche des champs pour les paramètres de requête et des champs pour les en-têtes.

    Notes

    Dans la console de test, Gestion des API renseigne automatiquement un en-tête Ocp-Apim-Subscription-Key, et configure la clé d’abonnement de l’abonnement avec accès complet intégré. Cette clé permet d’accéder à toutes les API dans l’instance Gestion des API. Vous pouvez éventuellement afficher l’en-tête Ocp-Apim-Subscription-Key en sélectionnant l’icône « œil » en regard de la requête HTTP.

  4. En fonction de l’opération, entrez des valeurs de paramètre de requête, des valeurs d’en-tête ou un corps de requête. Sélectionnez Envoyer.

    Lorsque le test réussit, le backend répond avec un code de réponse HTTP réussi et quelques données.

    Conseil

    Par défaut, la console de test envoie une demande au proxy CORS de Gestion des API, qui transmet la demande à l'instance d'API Management, qui la transmet ensuite au backend. Ce proxy utilise l'adresse IP publique 13.91.254.72 et ne peut atteindre que les terminaux publics. Si vous souhaitez envoyer une requête directement du navigateur au service Gestion des API, sélectionnez Bypass CORS proxy. Utilisez cette option lorsque vous souhaitez utiliser la console de test et que votre passerelle de Gestion des API est isolée du réseau ou n'autorise pas le trafic provenant du proxy CORS.

Pour déboguer une API, consultez Tutoriel : Déboguer vos API à l’aide du suivi des requêtes.

Ajouter d’autres API

Vous pouvez composer une API à partir de plusieurs API exposées par différents services, notamment :

  • Une spécification OpenAPI
  • Une API SOAP
  • Une API GraphQL
  • Une application web hébergée dans Azure App Service
  • Application Azure Function
  • Azure Logic Apps
  • Azure Service Fabric

Pour ajouter une autre API à votre API existante, effectuez les étapes suivantes.

Notes

Une fois que vous avez importé une autre API, les opérations sont ajoutées à votre API actuelle.

  1. Accédez à votre instance Gestion des API Azure dans le portail Azure.

    Accéder à l’instance Gestion des API Azure

  2. Sélectionnez API dans la page Vue d’ensemble ou dans le menu situé à gauche.

    Sélectionner des API

  3. Cliquez sur ... à côté de l’API à laquelle vous souhaitez ajouter une autre API.

  4. Sélectionnez Importer dans le menu déroulant.

    Sélectionner Importer

  5. Sélectionnez un service à partir duquel importer une API.

    Sélectionner un service

Valider par rapport à une spécification OpenAPI

Vous pouvez configurer la stratégies de validation Gestion des API pour valider les requêtes et réponses (ou leurs éléments) par rapport au schéma dans une spécification OpenAPI. Par exemple, utilisez la stratégie validate-content pour valider la taille ou le contenu d’une requête//du corps d’une réponse.

Étapes suivantes