Partager via


Importer une application logique en tant qu’API

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

Cet article explique comment importer une application logique en tant qu’API, et tester l’API importée.

Remarque

Cette fonctionnalité n’est actuellement pas disponible dans les espaces de travail.

Dans cet article, vous apprendrez comment :

  • Importer une application logique en tant qu’API
  • Tester l’API dans le portail Azure

Notes

Gestion des API prend en charge l’importation automatisée d’une ressource d’application logique (Consommation). qui s’exécute dans l’environnement Logic Apps multilocataire. En savoir plus sur Logic Apps avec un ou plusieurs locataires.

Prérequis

Accéder à votre instance Gestion des API

  1. Dans le Portail Azure, recherchez et sélectionnez Services API Management.

    Sélectionnez les services Gestion des API

  2. Dans la page Services Gestion des API, sélectionnez votre instance Gestion des API.

    Sélectionnez votre instance Gestion des API

Importer et publier une API back-end

  1. À partir du portail Azure, accédez à votre service Gestion des API, puis sélectionnez API dans le menu.

  2. Sélectionnez Application logique dans la liste Ajouter une nouvelle API.

    Sélectionner une catégorie d’application logique

  3. Appuyez sur Parcourir pour afficher la liste des applications logiques avec déclencheur HTTP de votre abonnement.

    • Les applications logiques sans déclencheur HTTP n’apparaissent pas dans la liste.

    Rechercher les applications logiques existantes avec un déclencheur correct

  4. Sélectionnez l’application logique.

    Sélectionner l’application logique

  5. Gestion des API recherche le swagger associé à l’application sélectionnée, l’extrait et l’importe.

  6. Ajoutez un suffixe d’URL d’API.

    • Le suffixe identifie cette API spécifique de façon unique dans cette instance Gestion des API.

    Compléter les champs

  7. Si vous voulez que l’API soit publiée et disponible pour les développeurs, basculez vers la vue complète et associez-la à un produit. Nous utilisons le produit « illimité » dans cet exemple.

    • Vous pouvez ajouter votre API à un produit au moment de la création ou plus tard par le biais de l’onglet Paramètres.

    Notes

    Les produits sont des associations d’une ou de plusieurs API proposées aux développeurs par le biais du portail des développeurs. Les développeurs doivent d’abord s’abonner à un produit pour obtenir l’accès à l’API. Une fois abonnés, ils obtiennent une clé d’abonnement pour toutes les API de ce produit. En tant que créateur de l’instance Gestion des API, vous êtes administrateur et abonné à chaque produit par défaut.

    Chaque instance Gestion des API est fournie avec deux exemples de produits par défaut :

    • Starter
    • Illimité
  8. Entrez d’autres paramètres d’API.

    • Vous pouvez définir ces valeurs au moment de la création ou plus tard en accédant à l’onglet Paramètres. Les paramètres sont expliqués dans le tutoriel Importer et publier votre première API.
  9. Sélectionnez Create (Créer).

Tester l’API dans le portail Azure

Les opérations peuvent être directement appelées depuis le portail Azure, qui permet d’afficher et de tester les opérations d’une API.

Tester l’application logique

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

  2. Appuyez sur l’onglet Test.

  3. Cliquez sur l’opération que vous souhaitez tester.

    • La page affiche des champs pour les paramètres de requête et les en-têtes.
    • L’un des en-têtes est « Ocp-Apim-Subscription-Key », pour la clé d’abonnement au produit associée à cette API.
    • En tant que créateur de l’instance Gestion des API, vous êtes déjà administrateur. Par conséquent, la clé est renseignée automatiquement.
  4. Appuyez sur Envoyer.

    • Quand le test réussit, le back-end répond par 200 OK et des données.

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

Notes

Chaque application logique a une opération manual-invoke. Pour inclure votre API de plusieurs applications logiques et éviter les collisions, vous devez renommer la fonction. Pour renommer la fonction ou l’API, accédez à l’éditeur de spécification OpenAPI et modifiez la valeur du titre.

Étapes suivantes