Dela via

Importera SOAP API till API Management

GÄLLER FÖR: Alla API Management-nivåer

Den här artikeln visar hur du importerar en WSDL-specifikation, som är en standard-XML-representation av ett SOAP-API. Artikeln visar också hur du testar API:et i API Management.

I den här artikeln kan du se hur du:

  • Importera ett SOAP-API
  • Testa API:et i Azure Portal

Anmärkning

WSDL-import till API Management omfattas av vissa begränsningar. WSDL-filer med wsdl:import, xsd:importoch xsd:include -direktiv stöds inte. Ett verktyg med öppen källkod för att lösa och sammanfoga dessa beroenden i en WSDL-fil finns i den här GitHub-lagringsplatsen.

Förutsättningar

Importera ett back-end-API

  1. I Azure Portal navigerar du till din API Management-instans.

  2. I den vänstra menyn väljer du API:er>+ Lägg till API.

  3. Under Skapa från definition väljer du WSDL.

    SOAP API

  4. I WSDL-specifikationen anger du URL:en till SOAP-API:et eller klickar på Välj en fil för att välja en lokal WSDL-fil.

  5. I Importmetod väljs SOAP vidarebefordran som standard. Med det här valet exponeras API:et som SOAP och API-konsumenter måste använda SOAP-regler. Om du vill ”restify” API:et, följer du stegen i Importera ett SOAP API och konvertera det till REST.

    Skapa SOAP API från WSDL-specifikation

  6. Följande API-inställningar fylls i automatiskt baserat på information från SOAP-API:et: Visningsnamn, Namn, Beskrivning. Åtgärderna fylls automatiskt i med Visningsnamn, URL och Beskrivning och får ett systemgenererat namn.

  7. Ange andra API-inställningar. Du kan ange värdena när du skapar eller konfigurera dem senare genom att gå till fliken Inställningar .

    Mer information om API-inställningar finns i handledningen Importera och publicera din första API.

  8. Välj Skapa.

Testa det nya API:et i portalen

Åtgärder kan anropas direkt från portalen, vilket är ett bekvämt sätt för administratörer att visa och testa åtgärderna i ett API.

  1. Välj det API som du skapade i föregående steg.

  2. Välj fliken Test.

  3. Välj en åtgärd. Sidan visar fält för frågeparametrar och fält för sidhuvudena.

    Anmärkning

    I testkonsolen fyller API Management automatiskt i huvudfältet Ocp-Apim-Subscription-Key och konfigurerar prenumerationsnyckeln för den inbyggda 'all-access'-prenumerationen. Den här nyckeln ger åtkomst till varje API i API Management-instansen. Du kan välja att visa Ocp-Apim-Subscription-Key header genom att klicka på "öga"-ikonen bredvid HTTP Request.

  4. Beroende på åtgärden anger du frågeparametervärden, rubrikvärden eller en begärandetext. Välj Skicka.

    När testet lyckas svarar serverdelen med en lyckad HTTP-svarskod och vissa data.

    Tips

    Som standard skickar testkonsolen en begäran till API Managements CORS-proxy, som vidarebefordrar begäran till API Management-instansen, som sedan vidarebefordrar den till serverdelen. Den här proxyn använder den offentliga IP-adressen 13.91.254.72 och kan bara nå offentliga slutpunkter. Om du vill skicka en begäran direkt från webbläsaren till API Management-tjänsten väljer du Kringgå CORS-proxy. Använd det här alternativet när du vill använda testkonsolen och DIN API Management-gateway är nätverksisolerad eller inte tillåter trafik från CORS-proxyn.

Information om hur du felsöker ett API finns i Självstudie: Felsöka dina API:er med hjälp av spårning av begäranden.

SOAP-åtgärd med wildcard

Om du behöver skicka en SOAP-begäran som inte har en dedikerad åtgärd definierad i API:et kan du konfigurera en SOAP-åtgärd med jokertecken. Jokerteckenåtgärden matchar alla SOAP-begäranden som inte har definierats i API:et.

Så här definierar du en jokerteckens-SOAP-aktion:

  1. I portalen väljer du det API som du skapade i föregående steg.
  2. På fliken Design väljer du + Lägg till åtgärd.
  3. Ange ett visningsnamn för åtgärden.
  4. I URL:en väljer du POST och anger /?soapAction={any} i resursen. Mallparametern inom klammerparenteserna är godtycklig och påverkar inte körningen.

Anmärkning

Använd inte OpenAPI-specifikationsredigeraren på fliken Design för att ändra ett SOAP-API.

Lägg till andra API:er

Du kan skapa ett API av API:er som exponeras av olika tjänster, inklusive:

  • En OpenAPI-specifikation
  • ETT SOAP-API
  • Ett GraphQL-API
  • En webbapp som finns i Azure App Service
  • Azure-funktioner
  • Azure Logic-appar
  • Azure Service Fabric

Anmärkning

När du importerar ett API läggs åtgärderna till i ditt aktuella API.

Så här lägger du till ett API i ett befintligt API:

  1. Gå till din Azure API Management-instans i Azure-portalen:

    Skärmbild som visar sidan API Management-tjänster.

  2. Välj API:er på sidan Översikt eller välj API:er>API:er på menyn till vänster.

    Skärmbild som visar valet av API:er på sidan Översikt.

  3. Välj ellipsen (...) bredvid det API som du vill lägga till ett annat API till.

  4. Välj Importera från den nedrullningsbara menyn:

    Skärmbild som visar kommandot Importera.

  5. Välj en tjänst som ett API ska importeras från.

Relaterat innehåll