SOAP API importeren

  • Artikel
  • 3 minuten om te lezen

Dit artikel laat zien hoe u een standaard XML-representatie van een SOAP API moet importeren. In het artikel wordt ook uitgelegd hoe u de API Management-API kunt testen.

In dit artikel leert u het volgende:

  • SOAP API importeren
  • De API testen in Azure Portal
  • De API testen in de ontwikkelaarsportal

Vereisten

Voltooi de volgende quickstart: Een Azure API Management-exemplaar maken

Ga naar uw API Management-exemplaar

  1. Zoek in de Azure-portal naar API Management-services en selecteer dit.

    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. Navigeer naar uw API Management-service in de Azure Portal en selecteer API's in het menu.

  2. Selecteer WSDL uit de lijst Nieuwe API toevoegen.

    SOAP API

  3. Geef in de WSDL-specificatie de URL op waar de SOAP API is opgeslagen.

  4. Het SOAP pass-through-keuzerondje is standaard geselecteerd. Met deze selectie zal de API worden weergegeven als SOAP. De consument moet SOAP-regels gebruiken. Als u van de API een REST API wilt maken, volg dan de stappen in Import a SOAP API and convert it to REST (Een SOAP API importeren en converteren naar REST).

    Schermopname toont het dialoogvenster Maken op basis van een W S D L waarin u een W S D L-specificatie kunt invoeren.

  5. Druk op tab.

    De volgende velden worden gevuld met de gegevens van de SOAP API: Weergavenaam, Naam, Beschrijving.

  6. Voeg een achtervoegsel toe van de URL voor de API. Het achtervoegsel is een naam die deze specifieke API in dit API Management-exemplaar identificeert. Het moet uniek zijn in dit API Management-exemplaar.

  7. Publiceer de API door deze aan een product te koppelen. In dit geval wordt het product onbeperkt gebruikt. Als u wilt dat de API wordt gepubliceerd en beschikbaar is voor ontwikkelaars, kunt u deze toevoegen aan een product. U kunt dit doen tijdens het maken van de API of het later instellen.

    Producten zijn koppelingen van een of meer API's. U kunt een aantal API's opnemen en deze beschikbaar stellen voor ontwikkelaars via de ontwikkelaarsportal. Ontwikkelaars moeten zich eerst abonneren op een product om toegang tot de API te krijgen. Wanneer ontwikkelaars zich abonneren, ontvangen ze een abonnementssleutel die toegang biedt tot elke API in het betreffende product. Als u het API Management-exemplaar hebt gemaakt, bent u al een beheerder en bent u standaard geabonneerd op elk product.

    Standaard wordt elk API Management-exemplaar geleverd met twee voorbeeldproducten:

    • Starter
    • Onbeperkt

  8. Voer andere API-instellingen in. U kunt de waarden instellen tijdens het maken of later configureren door naar het tabblad Instellingen te gaan. De instellingen worden beschreven in de zelfstudie Uw eerste API importeren en publiceren.

  9. Selecteer Maken.

De nieuwe API testen in de administratieve portal

Bewerkingen kunnen rechtstreeks vanuit de administratieve 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. Druk op het tabblad Testen.

  3. Selecteer een willekeurige bewerking.

    De pagina geeft velden weer 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 en wordt de sleutel dus automatisch ingevuld.

  4. Druk op Verzenden.

    Back-end reageert met 200 OK en enkele gegevens.

Andere API's toevoegen

U kunt een API opstellen met API's die beschikbaar worden gemaakt door verschillende services, waaronder:

  • De OpenAPI-specificatie
  • EEN SOAP-API
  • Een web-app die wordt gehost in Azure App Service
  • Azure Function-app
  • Azure Logic Apps
  • Azure Service Fabric

Gebruik de volgende stappen om een andere API toe te passen aan uw bestaande API.

Notitie

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

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

    Ga naar het Azure API Mgmt-exemplaar

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

    API's selecteren

  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.

    Service selecteren

Volgende stappen

Een gepubliceerde API transformeren en beveiligen