Dela via


Lägga till ett API manuellt

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

Den här artikeln visar steg för att lägga till ett API manuellt i API Management-instansen. När du vill håna API:et kan du skapa ett tomt API eller definiera det manuellt. Mer information om att testa API:er finns i Testa API-svar.

Om du vill importera ett befintligt API, se avsnittet relaterade ämnen.

I den här artikeln skapar vi ett tomt API och anger httpbin.org (en offentlig testtjänst) som ett serverdels-API.

Förutsättningar

Slutför följande snabbstart: Skapa en Azure API Management-instans

Gå till API Management-instansen

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

    Välj API Management-tjänster

  2. På sidan API Management-tjänster väljer du din API Management-instans.

    Välj din API Management-instans

Skapa ett API

  1. Gå till DIN API Management-tjänst i Azure-portalen och välj API:er på menyn.
  2. Välj + Lägg till API på den vänstra menyn.
  3. Välj HTTP i listan.
    Tomt API
  4. Ange webbadressen till serverdelens webbtjänst (till exempel https://httpbin.org) och andra inställningar för API:et. Inställningarna beskrivs i självstudien 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 en 404.

Kommentar

När du lägger till ett API, även om det är anslutet till någon 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 serverdelen "http://httpbin.org/get" operation.

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:en väljer du GET och anger /get i resursen.
  4. Ange FetchData som Visningsnamn.
  5. Välj Spara.

Testa en åtgärd

Testa åtgärden i Azure Portal. Du kan också testa det i utvecklarportalen.

  1. Välj fliken Test.
  2. Välj FetchData.
  3. Tryck på Skicka.

Svaret som "http://httpbin.org/get" åtgärden genererar visas. 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 fallet mappar vi åtgärden till "http://httpbin.org/status/200".

Lägg till åtgärden

  1. Välj det API som du skapade i föregående steg.
  2. Välj + Lägg till åtgärd.
  3. I URL:en väljer du GET och anger /status/{code} i resursen. Du kan också kan du ange information som är associerad med den här parametern. Ange till exempel Nummer för Typ, 200 (standard) för Värden.
  4. Ange GetStatus som Visningsnamn.
  5. Välj Spara.

Testa åtgärden

Testa åtgärden i Azure Portal. Du kan också testa det i utvecklarportalen.

  1. Välj fliken Test.

  2. Välj GetStatus. Som standard är kodvärdet satt till 200. Du kan ändra det för att testa andra värden. Ange till exempel 418.

  3. Tryck på Skicka.

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

Lägga till och testa en jokerteckenåtgärd

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

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ägg till åtgärden

  1. Välj det API som du skapade i föregående steg.
  2. Välj + Lägg till åtgärd.
  3. I URL:en väljer du GET och anger /* i resursen.
  4. Ange "Jokertecken" som Visningsnamn.
  5. Välj Spara.

Testa åtgärden

Testa åtgärden i Azure Portal. Du kan också testa det i utvecklarportalen.

  1. Välj fliken Test.

  2. Välj JokerteckenHämta. 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 uppdaterar du till exempel värdet bredvid jokertecknet (*) till headers. Åtgärden returnerar den inkommande begärans HTTP-huvuden.

  3. Tryck på Skicka.

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

Kommentar

Det kan vara viktigt att förstå hur värden för serverdels-API:et som du integrerar med hanterar avslutande 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 för 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-funktionsapp
  • Azure Logic Program-program
  • Azure Service Fabric

Lägg till ett annat API i ditt befintliga API med hjälp av följande steg.

Kommentar

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

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

    Gå till Azure API Mgmt-instans

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

    Välj API:er

  3. Klicka på ... intill det API som du vill lägga till ett annat API till.

  4. Välj Import från den nedrullningsbara menyn.

    Välj Importera

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

    Välj tjänst

Nästa steg