Delen via

Handmatig een API toevoegen

Van toepassing op: Alle API Management-lagen

In dit artikel wordt beschreven hoe u handmatig een API toevoegt aan Azure API Management. Wanneer u gesimuleerde antwoorden van de API wilt maken, kunt u een lege API maken. Zie Mock-API-antwoorden voor informatie over het maken van mock-API-antwoorden.

Als u een bestaande API wilt importeren, raadpleegt u de sectie Gerelateerde inhoud van dit artikel.

In dit artikel leert u hoe u een lege API maakt. U geeft httpbin.org (een openbare testservice) op als back-end-API.

Vereiste voorwaarden

Ga naar uw API-Beheerinstantie

  1. Zoek en selecteer in de Azure portalde API Management-services:

    Schermopname van API Management-services in de zoekresultaten.

  2. Selecteer op de pagina API Management-services uw API Management-exemplaar:

    Schermopname van een API Management-exemplaar op de pagina API Management-services.

Een API maken

  1. Selecteer API's in het linkermenu onder API's.

  2. Selecteer + API toevoegen.

  3. Selecteer de HTTP-tegel :

    Schermopname van de HTTP-tegel in de Azure-portal.

  4. Voer de URL van de back-endwebservice (bijvoorbeeld https://httpbin.org) en andere instellingen voor de API in. De instellingen worden beschreven in de zelfstudie Uw eerste API importeren en publiceren.

  5. Klik op Creëren.

Op dit moment hebt u geen bewerkingen in API Management die zijn toegewezen aan de bewerkingen in uw back-end-API. Als u een bewerking aanroept die wordt weergegeven via de back-end, maar niet via API Management, krijgt u een 404-fout.

Opmerking

Wanneer u een API toevoegt, zelfs als deze is verbonden met een back-endservice, worden in API Management standaard geen bewerkingen weergegeven totdat u ze toestaat. Als u een bewerking van uw back-endservice wilt toestaan, maakt u een API Management-bewerking die is toegewezen aan de back-endbewerking.

Een bewerking toevoegen en testen

In deze sectie ziet u hoe u een /get bewerking toevoegt om deze toe te wijzen aan de back-endbewerking http://httpbin.org/get .

Een bewerking toevoegen

  1. Selecteer de API die u in de vorige stap hebt gemaakt.
  2. Selecteer + Bewerking toevoegen.
  3. In URL, selecteer GET en voer /get in het tekstvak in.
  4. In Weergavenaam voert u FetchData in.
  5. Selecteer Opslaan.

De bewerking testen

Test de werking in de Azure-portal. (U kunt deze ook testen in de ontwikkelaarsportal.)

  1. Selecteer het tabblad Testen.
  2. Selecteer FetchData.
  3. Klik op Verzenden.

Het antwoord dat door de http://httpbin.org/get bewerking wordt gegenereerd, wordt weergegeven in de sectie HTTP-antwoord . Als u uw bewerkingen wilt transformeren, raadpleegt u Uw API transformeren en beveiligen.

Een geparameteriseerde bewerking toevoegen en testen

In deze sectie ziet u hoe u een bewerking toevoegt die een parameter gebruikt. In dit voorbeeld wijs je de bewerking toe aan http://httpbin.org/status/200.

Een bewerking toevoegen

  1. Selecteer de API die u eerder hebt gemaakt.
  2. Selecteer op het tabblad Ontwerpende optie + Bewerking toevoegen.
  3. Selecteer GET in de URL en voer /status/{code} in het tekstvak in.
  4. In Weergavenaam, voer GetStatus in.
  5. Selecteer Opslaan.

De bewerking testen

Test de werking in de Azure-portal. (U kunt deze ook testen in de ontwikkelaarsportal.)

  1. Selecteer het tabblad Testen.

  2. Selecteer GetStatus. Voer 200 in code in.

  3. Klik op Verzenden.

    Het antwoord dat door de http://httpbin.org/status/200 bewerking wordt gegenereerd, wordt weergegeven in de sectie HTTP-antwoord . Als u uw bewerkingen wilt transformeren, raadpleegt u Uw API transformeren en beveiligen.

Een wildcardbewerking toevoegen en testen

In deze sectie ziet u hoe u een wildcardbewerking toevoegt. Met een jokertekenbewerking kunt u een willekeurige waarde doorgeven aan een API-aanvraag. In plaats van afzonderlijke GET-bewerkingen te maken, zoals wordt weergegeven in de vorige secties, kunt u een GET-bewerking met jokertekens maken.

Waarschuwing

Wees voorzichtig wanneer u een wildcard configureert. Deze configuratie kan een API kwetsbaarder maken voor bepaalde API-beveiligingsrisico's.

Een bewerking toevoegen

  1. Selecteer de API die u eerder hebt gemaakt.
  2. Selecteer op het tabblad Ontwerpende optie + Bewerking toevoegen.
  3. In de URL, selecteer GET en voer /* in het tekstvak in.
  4. Voer in WeergavenaamWildcardGet in.
  5. Selecteer Opslaan.

De bewerking testen

Test de werking in de Azure-portal. (U kunt deze ook testen in de ontwikkelaarsportal.)

  1. Selecteer het tabblad Testen.

  2. Selecteer WildcardGet. Probeer de GET-bewerkingen die u in de vorige secties hebt getest of probeer een andere ondersteunde GET-bewerking.

    Wijzig bijvoorbeeld in sjabloonparameters de waarde bij de naam van het wildcardsymbool (*) naar headers. De bewerking retourneert de HTTP-headers van de binnenkomende aanvraag.

  3. Klik op Verzenden.

    Het antwoord dat door de http://httpbin.org/headers bewerking wordt gegenereerd, wordt weergegeven in de sectie HTTP-antwoord . Als u uw bewerkingen wilt transformeren, raadpleegt u Uw API transformeren en beveiligen.

Opmerking

Het kan belangrijk zijn om te begrijpen hoe de host voor de backend-API waarmee u integreert omgaat met achterliggende schuine strepen op een bewerkings-URL. Zie deze veelgestelde vragen over API Management voor meer informatie.

Andere API's toevoegen

U kunt een API samenstellen uit API's die worden weergegeven door verschillende services, waaronder:

  • Een OpenAPI-specificatie
  • Een SOAP-API
  • Een GraphQL-API
  • Een web-app die wordt gehost in Azure App Service
  • Azure Functions (serverloze computerdiensten van Azure)
  • Azure Logic Apps
  • Azure Service Fabric

Opmerking

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

Een API toevoegen aan een bestaande API:

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

    Schermopname van de pagina API Management-services.

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

    Screenshot van de selectie van API's op de pagina 'Overzicht'.

  3. Selecteer het beletselteken (#A0 ... #A1) naast de API waaraan u een andere API wilt toevoegen.

  4. Selecteer Import uit het vervolgkeuzemenu.

    Schermopname van de opdracht importeren.

  5. Selecteer de service waaruit een API moet worden geïmporteerd.

Verwante inhoud