Partager via

Importer une API SOAP dans API Management et la convertir en REST

S'APPLIQUE À : Tous les niveaux de gestion des API

Cet article montre comment importer une API SOAP en tant que spécification WSDL, puis la convertir en API REST. Il montre également comment tester l’API dans Azure API Management.

Dans cet article, vous apprendrez comment :

  • Importer une API SOAP et la convertir en REST
  • Tester l'API dans le Portail Microsoft Azure

Remarque

L’importation de WSDL dans Gestion des API est soumise à certaines limitations. Les fichiers WSDL ayant les directives wsdl:import, xsd:import et xsd:include ne sont pas pris en charge. Pour obtenir un outil open source permettant de résoudre et de fusionner ces dépendances dans un fichier WSDL, consultez ce référentiel GitHub.

Prérequis

Accéder à votre instance de gestion des API

  1. Dans le portail Azure, recherchez et sélectionnez Services de gestion des API :

    Capture d’écran qui montre les services de gestion des API dans les résultats de recherche.

  2. Sur la page des services de gestion des API, sélectionnez votre instance de gestion des API :

    Capture d’écran qui montre une instance de gestion des API sur la page des services de gestion des API.

Importer et publier une API backend

  1. Dans le volet de gauche, dans la section APIs, sélectionnez APIs.

  2. Sur la page API, sélectionnez + Ajouter une API.

  3. Sous Créer à partir de la définition, sélectionnez WSDL :

    Capture d’écran qui montre la vignette WSDL dans le Portail Microsoft Azure.

  4. Dans la spécification WSDL, entrez l’URL de votre API SOAP ou cliquez sur Sélectionner un fichier pour sélectionner un fichier WSDL local.

  5. Sous Méthode d'importation, sélectionnez SOAP vers REST. Lorsque cette option est sélectionnée, API Management tente d’effectuer une transformation automatique entre XML et JSON. Dans ce cas, les consommateurs doivent appeler l’API comme une API RESTful, qui renvoie JSON. La gestion des API convertit chaque requête en un appel SOAP.

    Capture d'écran qui montre l'option SOAP vers REST.

  6. Les cases Nom d'affichage et Nom sont remplies automatiquement avec les informations de l'API SOAP.

    Le nom d'affichage, l'URL et les informations de description sont automatiquement saisis pour les opérations. Les opérations reçoivent également un Nom généré par le système.

  7. Saisissez d’autres paramètres API, puis sélectionnez Créer. Vous pouvez également configurer ces valeurs ultérieurement en allant dans l'onglet Paramètres.

    Pour plus d'informations sur les paramètres de l'API, consultez Importer et publier votre première API.

Tester la nouvelle API dans le Portail Microsoft Azure

Vous pouvez appeler des opérations directement depuis le Portail Microsoft Azure. Cette méthode fournit un moyen pratique de visualiser et de tester 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. L'un des en-têtes est Ocp-Apim-Subscription-Key. Cet en-tête concerne la clé d'abonnement du produit associé à cette API. Si vous avez créé l'instance de gestion des API, vous êtes déjà administrateur, la clé est donc renseignée automatiquement.

  4. Sélectionnez Envoyer.

    Lorsque le test est réussi, le backend répond avec 200 OK et quelques données.

Ajouter d'autres API

Vous pouvez composer une API à partir d'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
  • Les fonctions Azure
  • Azure Logic Apps
  • Azure Service Fabric

Remarque

Lorsque vous importez une API, les opérations sont ajoutées à votre API actuelle.

Pour ajouter une API à une API existante :

  1. Accédez à votre instance Azure API Management dans le Portail Microsoft Azure :

    Capture d’écran qui montre la page des services de gestion des API.

  2. Sélectionnez APIs dans la page Vue d’ensemble, ou sélectionnez APIs>APIs dans le menu de gauche.

    Capture d'écran qui montre la sélection des API sur la page Présentation.

  3. Sélectionnez les points de suspension (...) à côté de l’API à laquelle vous souhaitez ajouter une autre API.

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

    Capture d'écran qui montre la commande Importer.

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

Contenu connexe