Lezen in het Engels

Delen via

SOAP-API importeren in API Management en converteren naar REST

  • Artikel

VAN TOEPASSING OP: Alle API Management-lagen

In dit artikel wordt beschreven hoe u een SOAP-API importeert als een WSDL-specificatie en deze vervolgens converteert naar een REST API. In het artikel wordt ook beschreven hoe u de API kunt testen in API Management.

In dit artikel leert u het volgende:

  • Een SOAP-API importeren en deze 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

Lees de volgende snelstart: Een Azure API Management-exemplaar maken

Ga naar uw API Management-exemplaar

  1. Zoek en selecteer API Management-services in Azure Portal.

    API Management-services selecteren

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

    Uw API Management-exemplaar selecteren

Een back-end-API importeren en publiceren

  1. Selecteer IN het linkermenu, onder de sectie API's, API's>+ API toevoegen.

  2. Selecteer WSDL onder Maken op basis van definitie.

    SOAP API

  3. Voer in de WSDL-specificatie de URL naar uw SOAP-API in of selecteer een bestand selecteren om een lokaal WSDL-bestand te selecteren.

  4. Selecteer SOAP naar REST in de importmethode. 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.

    SOAP naar REST

  5. De volgende velden worden automatisch ingevuld met informatie uit de SOAP-API: Weergavenaam, Naam, Beschrijving. Bewerkingen worden automatisch gevuld met weergavenaam, URL en beschrijving en ontvangen een door het systeem gegenereerde naam.

  6. Voer andere API-instellingen in. U kunt de waarden instellen tijdens het maken of later configureren door naar het tabblad Instellingen te gaan.

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

  7. Selecteer Maken.

De nieuwe API testen in de Azure-portal

Bewerkingen kunnen rechtstreeks vanuit Azure Portal worden aangeroepen. Dit is een handige manier om de bewerkingen van een API te bekijken 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 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. Druk 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 opstellen van API's die beschikbaar worden gesteld door verschillende services, waaronder:

  • Een OpenAPI-specificatie
  • Een SOAP-API
  • Een GraphQL-API
  • Een web-app die wordt gehost in Azure-app Service
  • Azure Function-app
  • Azure Logic-apps
  • Azure Service Fabric

Voeg een andere API toe aan uw bestaande API met behulp van de volgende stappen.

Notitie

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

  1. Ga naar uw Azure API Management-exemplaar in de Azure-portal.

    Schermopname van het navigeren naar het API Management-exemplaar in de portal.

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

    Schermopname van het selecteren van API's op de pagina Overzicht in de portal.

  3. Selecteer het beletselsteken (... ) naast de API waaraan u een andere API wilt toevoegen.

  4. Selecteer Importeren in de vervolgkeuzelijst.

    Importeren selecteren

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

    Schermopname van het selecteren van een service in de portal.

Volgende stappen

Een gepubliceerde API transformeren en beveiligen