Delen via

Een SOAP-API importeren in API Management en deze converteren naar REST

VAN TOEPASSING OP: Alle API Management-niveaus

In dit artikel wordt beschreven hoe u een SOAP-API importeert als een WSDL-specificatie en deze vervolgens converteert naar een REST API. Ook ziet u hoe u de API test in Azure API Management.

In dit artikel leert u het volgende:

  • Een SOAP-API importeren en converteren naar REST
  • De API testen in Azure Portal

Notitie

WSDL-import naar API Management is onderhevig aan bepaalde beperkingen. WSDL-bestanden met wsdl:import, xsd:importen xsd:include richtlijnen worden niet ondersteund. Voor een opensource-hulpprogramma om deze afhankelijkheden in een WSDL-bestand op te lossen en samen te voegen, raadpleegt u deze GitHub-opslagplaats.

Vereisten

Ga naar uw API Management-instantie

  1. Zoek en selecteer in de Azure portalde API Management-services:

    Schermopname van API Management-services in de zoekresultaten.

  2. Selecteer op de pagina API Management-services uw API Management-exemplaar:

    Schermopname van een API Management-exemplaar op de pagina API Management-services.

Een API importeren en publiceren

  1. Selecteer API's in het linkerdeelvenster in de sectie API's.

  2. Selecteer + API toevoegen op de pagina API's.

  3. Selecteer WSDL onder Maken vanuit definitie:

    Schermopname van de WSDL-tegel in de Azure Portal.

  4. Voer in de WSDL-specificatie de URL naar uw SOAP-API in of klik op Een bestand selecteren om een lokaal WSDL-bestand te selecteren.

  5. Selecteer onder ImportmethodeSOAP to REST. Wanneer deze optie is geselecteerd, probeert API Management een automatische transformatie tussen XML en JSON uit te voeren. In dit geval moeten consumenten de API aanroepen als een RESTful-API, die JSON retourneert. API Management converteert elke aanvraag naar een SOAP-aanroep.

    Schermopname van de optie SOAP naar REST.

  6. De vakken Weergavenaam en Naam worden automatisch gevuld met informatie uit de SOAP-API.

    Informatie over weergavenaam, URL en beschrijving wordt automatisch ingevoerd voor bewerkingen. Bewerkingen ontvangen ook een door het systeem gegenereerde naam.

  7. Voer andere API-instellingen in en selecteer Maken. U kunt deze waarden later ook configureren door naar het tabblad Instellingen te gaan.

    Zie Uw eerste API importeren en publiceren voor meer informatie over API-instellingen.

De nieuwe API testen in de Azure-portal

U kunt bewerkingen rechtstreeks vanuit Azure Portal aanroepen. Deze methode biedt een handige manier om de bewerkingen van een API weer te geven en te testen.

  1. Selecteer de API die u in de vorige stap hebt gemaakt.

  2. Selecteer het tabblad Testen.

  3. Selecteer een bewerking.

    De pagina bevat velden voor queryparameters en velden voor de headers. Een van de headers is Ocp-Apim-Subscription-Key. Deze header is bedoeld voor de abonnementssleutel van het product dat is gekoppeld aan deze API. Als u het API Management-exemplaar hebt gemaakt, bent u al een beheerder, zodat de sleutel automatisch wordt ingevuld.

  4. Klik op Verzenden.

    Wanneer de test is geslaagd, reageert de back-end met 200 OK en enkele gegevens.

Andere API's toevoegen

U kunt een API samenstellen uit API's die worden weergegeven door verschillende services, waaronder:

  • Een OpenAPI-specificatie
  • Een SOAP-API
  • Een GraphQL-API
  • Een web-app die wordt gehost in Azure App Service
  • Azure Functions (serverloze computerdiensten van Azure)
  • Azure Logic Apps
  • Azure Service Fabric

Notitie

Wanneer u een API importeert, worden de bewerkingen toegevoegd aan uw huidige API.

Een API toevoegen aan een bestaande API:

  1. Ga naar uw Azure API Management-exemplaar in Azure Portal:

    Schermopname van de pagina API Management-services.

  2. Selecteer API's op de Overzicht pagina of selecteer API's>API's in het menu aan de linkerkant.

    Screenshot van de selectie van API's op de pagina 'Overzicht'.

  3. Selecteer het beletselteken (#A0 ... #A1) naast de API waaraan u een andere API wilt toevoegen.

  4. Selecteer Import uit het vervolgkeuzemenu.

    Schermopname van de opdracht importeren.

  5. Selecteer de service waaruit een API moet worden geïmporteerd.

Verwante inhoud