Een logische app als API importeren

  • Artikel
  • 3 minuten om te lezen

In dit artikel wordt uitgelegd hoe u een logische app als een API importeert en de geïmporteerde API vervolgens test.

In dit artikel leert u het volgende:

  • Een logische app als API importeren
  • De API testen in Azure Portal

Vereisten

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 logische app uit de lijst Nieuwe API toevoegen.

    Categorie logische app selecteren

  3. Druk op Bladeren voor een overzicht van de logische apps met een HTTP-trigger in uw abonnement.

    • Logische apps zonder HTTP-trigger worden niet weergegeven in de lijst.

    Bladeren naar bestaande logische apps met de juiste trigger

  4. Selecteer de logische app.

    Logische app selecteren

  5. API Management zoekt de swagger die is gekoppeld aan de geselecteerde app, haalt deze op en importeert deze.

  6. Voeg een achtervoegsel toe van de URL voor de API.

    • Het achtervoegsel identificeert deze specifieke API op unieke manier in API Management instantie.

    Velden voltooien

  7. Als u wilt dat de API wordt gepubliceerd en beschikbaar is voor ontwikkelaars, schakelt u over naar de volledige weergave en koppelt u deze aan een Product. In dit voorbeeld gebruiken we het product Onbeperkt.

    • U kunt uw API toevoegen aan een product tijdens het maken of later via Instellingen tabblad.

    Notitie

    Producten zijn associaties van een of meer API's die aan ontwikkelaars worden aangeboden via de ontwikkelaarsportal. Eerst moeten ontwikkelaars zich abonneren op een product om toegang te krijgen tot de API. Zodra ze zich hebben geabonneerd, krijgen ze een abonnementssleutel voor elke API in dat product. Als maker van het API Management bent u een beheerder en bent u standaard geabonneerd op elk product.

    Elk API Management wordt geleverd met twee standaardvoorbeeldproducten:

    • Starter
    • Onbeperkt

  8. Voer andere API-instellingen in.

    • U kunt deze waarden instellen tijdens het maken of later door naar het tabblad Instellingen gaan. De instellingen worden uitgelegd in de zelfstudie Uw eerste API importeren en publiceren.

  9. Selecteer Maken.

De API testen in 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.

De logische app testen

  1. Selecteer de API die u in de vorige stap hebt gemaakt.

  2. Druk op het tabblad Testen.

  3. Selecteer de bewerking die u wilt testen.

    • Op de pagina worden velden weergegeven voor queryparameters en headers.
    • Een van de headers is Ocp-Apim-Subscription-Key voor de productabonnementssleutel die aan deze API is gekoppeld.
    • Als maker van API Management-instantie bent u al een beheerder, dus de sleutel wordt automatisch ingevuld.

  4. Druk op Verzenden.

    • Wanneer de test is geslaagd, reageert de back-end met 200 OK en 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

Notitie

Elke logische app heeft functionaliteit voor handmatig aanroepen. Als u uw API uit meerdere logische apps wilt maken en een aanrijding wilt voorkomen, moet u de naam van de functie wijzigen. Als u de naam van de functie/API wilt wijzigen, gaat u naar de Editor voor OpenAPI-specificatie en wijzigt u de waarde van de titel.

Volgende stappen

Een gepubliceerde API transformeren en beschermen