Dela via

Lägga till ett API manuellt

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

Den här artikeln visar hur du manuellt lägger till ett API i Azure API Management. När du vill skapa falska svar från API:et kan du skapa ett tomt API. Information om hur du skapar falska API-svar finns i Mock API responses (Simulera API-svar).

Om du vill importera ett befintligt API kan du läsa avsnittet Relaterat innehåll i den här artikeln.

I den här artikeln får du lära dig hur du skapar ett tomt API. Du anger httpbin.org (en offentlig testtjänst) som ett serverdels-API.

Förutsättningar

Gå till API Management-instansen

  1. I Azure -portalensöker du efter och väljer API Management-tjänster:

    Skärmbild som visar API Management-tjänster i sökresultaten.

  2. På sidan API Management Services väljer du din API Management-instans:

    Skärmbild som visar en API Management-instans på sidan API Management-tjänster.

Skapa ett API

  1. Under API:er i den vänstra menyn väljer du API:er.

  2. Välj + Lägg till API.

  3. Välj HTTP-panelen :

    Skärmbild som visar HTTP-panelen i Azure-portalen.

  4. Ange webbadressen till serverdelens webbtjänst (till exempel https://httpbin.org) och andra inställningar för API:et. Inställningarna förklaras i handledningen Importera och publicera ditt första API.

  5. Välj Skapa.

I det här läget har du inga åtgärder i API Management som mappar till åtgärderna i serverdels-API:et. Om du anropar en åtgärd som exponeras via serverdelen men inte via API Management får du ett 404-fel.

Anteckning

När du lägger till ett API, även om det är anslutet till en serverdelstjänst, exponerar API Management som standard inga åtgärder förrän du tillåter dem. Om du vill tillåta en åtgärd för serverdelstjänsten skapar du en API Management-åtgärd som mappar till serverdelsåtgärden.

Lägg till och testa en åtgärd

Det här avsnittet visar hur du lägger till en /get åtgärd för att mappa den till serverdelsåtgärden http://httpbin.org/get .

Lägga till en åtgärd

  1. Välj det API som du skapade i föregående steg.
  2. Välj + Lägg till åtgärd.
  3. I URL väljer du GET och anger /get i textrutan.
  4. I Visningsnamn anger du FetchData.
  5. Välj Spara.

Testa åtgärden

Testa åtgärden i Azure Portal. (Du kan också testa den i utvecklarportalen.)

  1. Välj fliken Test.
  2. Välj FetchData.
  3. Välj Skicka.

Svaret som åtgärden http://httpbin.org/get genererar visas i avsnittet HTTP-svar . Om du vill omvandla dina åtgärder, se Omvandla och skydda ditt API.

Lägg till och testa en parameteriserad åtgärd

Det här avsnittet visar hur du lägger till en åtgärd som tar en parameter. I det här exemplet mappar du åtgärden till http://httpbin.org/status/200.

Lägga till en åtgärd

  1. Välj det API som du skapade tidigare.
  2. På fliken Design väljer du + Lägg till åtgärd.
  3. I URL väljer du GET och anger /status/{code} i textrutan.
  4. I Visningsnamn anger du GetStatus.
  5. Välj Spara.

Testa åtgärden

Testa åtgärden i Azure Portal. (Du kan också testa den i utvecklarportalen.)

  1. Välj fliken Test.

  2. Välj GetStatus. I kod skriver du 200.

  3. Välj Skicka.

    Svaret som åtgärden http://httpbin.org/status/200 genererar visas i avsnittet HTTP-svar . Om du vill omvandla dina åtgärder, se Omvandla och skydda ditt API.

Lägga till och testa en wildcard-operation

Det här avsnittet visar hur du lägger till en jokerteckensoperation. Med en wildcard-funktion kan du skicka ett godtyckligt värde med en API-förfrågan. I stället för att, som visas i föregående avsnitt, skapa separata GET-åtgärder kan du skapa en jokerteckens GET-åtgärd.

Varning

Var försiktig när du konfigurerar en jokerteckenåtgärd. Den här konfigurationen kan göra ett API mer sårbart för vissa API-säkerhetshot.

Lägga till en åtgärd

  1. Välj det API som du skapade tidigare.
  2. På fliken Design väljer du + Lägg till åtgärd.
  3. I URL väljer du GET och anger /* i textrutan.
  4. I Visningsnamn skriver du in WildcardGet.
  5. Välj Spara.

Testa åtgärden

Testa åtgärden i Azure Portal. (Du kan också testa den i utvecklarportalen.)

  1. Välj fliken Test.

  2. Välj WildcardGet. Prova de GET-åtgärder som du testade i föregående avsnitt eller prova en annan GET-åtgärd som stöds.

    I Mallparametrar ändrar du till exempel värdet bredvid jokertecknet (*) till rubriker. Åtgärden returnerar den inkommande begärans HTTP-huvuden.

  3. Välj Skicka.

    Svaret som åtgärden http://httpbin.org/headers genererar visas i avsnittet HTTP-svar . Om du vill omvandla dina åtgärder, se Omvandla och skydda ditt API.

Anteckning

Det kan vara viktigt att förstå hur värden till det backend-API du integrerar med hanterar slutande snedstreck på en åtgärds-URL. Mer information finns i vanliga frågor och svar om API Management.

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

Anteckning

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