Een API-gateway maken
Organisaties moeten vaak partners toegang geven tot gegevens. Deze toegang moet worden gecontroleerd en beheerd.
In het voorbeeld van het schoenenbedrijf moeten retailers die NorthWind Shoes in voorraad hebben, weten hoeveel voorraad ze kunnen bestellen. Klanten willen ook graag precies weten wanneer ze hun bestelling krijgen.
Hier leert u hoe Azure API Management werkt en hoe u een API-gateway instelt.
Azure API Management
De Azure API Management-service wordt gehost in de Azure-cloud en bevindt zich tussen uw API's en internet. Uw API Management-exemplaar fungeert als een Azure API-gateway.
Wanneer u uw API's publiceert, gebruikt u Azure Portal om te bepalen hoe bepaalde API's beschikbaar worden gesteld voor gebruikers. Mogelijk wilt u dat sommige API's vrij beschikbaar zijn voor ontwikkelaars, voor demotoepassingen en voor toegang tot andere API's om strikt te worden beheerd.
Waarom API Management gebruiken?
Voor ontwikkelaars biedt API Management een scala aan voordelen.
- API-documentatie. Documentatie van API's maakt het mogelijk om clients aan te roepen om hun oplossingen snel te integreren. Met API Management kunt u snel de structuur van uw API beschikbaar maken voor het aanroepen van clients via moderne standaarden, zoals OpenAPI. U kunt meer dan één versie van een API hebben. Met meerdere versies kunt u app-updates uitvoeren omdat uw verbruikende apps de nieuwe versie niet meteen hoeven te gebruiken.
- Frequentielimiet voor toegang. Als uw API mogelijk toegang heeft tot een grote hoeveelheid gegevens, kunt u het beste de frequentie beperken waarmee clients gegevens kunnen opvragen. Een frequentielimiet helpt bij het behouden van optimale reactietijden voor elke client. Met API Management kunt u frequentielimieten instellen als geheel of voor specifieke afzonderlijke clients.
- Statuscontrole. Externe clients gebruiken uw API's, zodat het lastig kan zijn om potentiële problemen of fouten te identificeren. Met API Management kunt u foutberichten en logbestanden bekijken en filteren op typen antwoorden.
- Hedendaagse indelingen zoals JSON. In de loop der jaren werden veel verschillende indelingen voor gegevensuitwisseling gebruikt door API's van XML naar CSV en nog veel meer. Met API Management kunt u deze indelingen weergeven met behulp van moderne gegevensmodellen zoals JSON.
- Verbindingen met een API. In veel bedrijven bevinden API's zich in verschillende landen/regio's en gebruiken ze verschillende indelingen. Met API Management kunt u al deze verschillende API's toevoegen aan één moderne interface.
- Analyse. Als u API's ontwikkelt, is het handig om te zien hoe vaak uw API's worden aangeroepen en door welke typen systemen. Met API Management kunt u deze gegevens visualiseren in Azure Portal.
- Beveiliging. Beveiliging is cruciaal bij het omgaan met systeemgegevens. Ongeoorloofde beveiligingsschendingen kunnen bedrijven geld en verloren tijd bij het herwerken van code en reputatieverlies kosten. Beveiligingshulpprogramma's die u met Azure API Management kunt gebruiken, zijn OAuth 2.0-gebruikersautorisatie en integratie met Microsoft Entra-id.
- Prijscategorieën. API Management biedt lagen met verschillende mogelijkheden voor aanvraagdoorvoer, service level agreement (SLA), netwerkisolatie, upgradeflexibiliteit, enzovoort. Wanneer u een Azure API Management-gateway maakt, kiest u de laag die aan uw behoeften voldoet.
API-beheer instellen
Voor het instellen van API-beheer kunt u:
- Een API Management-gateway maken. De naam die u voor de gateway gebruikt, moet globaal uniek zijn binnen de .azure-api.net-naamruimte.
- Registreer een bestaande web-API bij de gateway. Door het registreren van de API is de API beschikbaar voor consumenten op het <gateway>.azure-api.net-eindpunt.
- De bestaande API aanroepen via de gateway. Consumenten kunnen nu de API aanroepen op de eindpunt-URL.