De WSO2 API Manager is een veel gebruikt open-source API-management platform dat volgens Forrester-Wave inmiddels een positie als marktleider heeft ingenomen. Met de API Manager versie 4 die in mei 2021 uitkwam is het naar nog grotere hoogte gestegen. De WSO2 API Manager 4.0.0 is de opvolger van zowel de WSO2 API Manager 3.2.0 als de WSO2 Enterprise Integrator 7.1. In deze release worden API Management en Integratie mogelijkheden samengebracht in één oplossing. In deze blog neem ik je mee langs een aantal in het oog springende features die toegevoegd zijn aan de WSO2 API Manager 4.0.0 die zeker voor developers erg prettig zijn.
Ondersteuning voor Streaming API’s en Event-driven architectures (EDA’s)
De WSO2 API Manager 4.0.0 biedt hoogwaardige ondersteuning voor streaming API’s en event-driven architectures (EDA’s) door naast het WebSocket protocol nu ook ASyncAPI specification en protocolondersteuning voor WebHook/WebSub en Server-Sent Events (SSE) te faciliteren. Het is noemenswaardig dat de WSO2 API Manager het enige API-managementplatform is dat out-of-the-box volledige ondersteuning biedt voor streaming API’s and event-driven architectures.
- Ondersteuning voor Streaming API’s
Door de snelle adoptie van EDA’s zijn er steeds meer organisaties die vertrouwen op gegevens in event streams in plaats van in databases in een traditionele architectuur. Events die opgeslagen worden in de onderwerpen, worden gezien als enige ware bron, waarbij een bron gezien kan worden als een Tabel in een database. Nu kunnen deze event streams via de WSO2 API Manager opengesteld worden voor externe clients en applicaties zoals gemanagede Streaming API’s. Streaming API’s kunnen opengesteld worden via WebSocket, WebHook of SSE protocollen. Er wordt nu ondersteuning geboden voor het abonneren op en het publiceren van events vanuit de client. In termen van fine-grained access control kan er gebruik gemaakt worden van OAuth scopes om clients een beperking op te leggen op welke topics/wachtrijen ze kunnen abonneren en/of in welke ze kunnen publiceren. - Ondersteuning voor ASyncAPI Specification
ASyncAPI Specification werd geïntroduceerd om de interfaces van streaming API’s te documenteren op een manier die vergelijkbaar is met die van REST API’s, waarbij gebruik gemaakt wordt van Open API Specification. De API Manager biedt de mogelijkheid om bestaande async/streaming API’s te importeren met de ASyncAPI definitie of een ASyncAPI definitie te genereren voor nieuw gecreëerde event API’s. De gegenereerde specificatie kan handmatig aangepast worden en wordt vervolgens geüpdate op het moment dat er een verandering in de API gemaakt wordt. Hierdoor kunnen ASyncAPI ontwikkelaars zich richten op de ontwikkelingsaspecten van de API, in plaats van op de documentatie, terwijl de API-abonnees op de API-specificaties kunnen vertrouwen. - Streaming API’s die het WebSocket protocol gebruiken
Het WebSocket protocol maakt full-duplex communicatie mogelijk en werd al in eerdere versies van de WSO2 API Manager ondersteund. Maar met de nieuwe streaming API-ondersteuning kunnen ontwikkelaars nu hun event streams via het WebSocket protocol openstellen. Hierdoor zijn clients in staat om als publisher én als abonnee te handelen. - Ondersteuning voor het Server-Sent Events (SSE-)protocol
Het SSE-protocol is een eenrichtings-protocol waarin de server de events naar de geabonneerde clients pushed via HTTP. Het is efficiënt omdat het gebruik maakt van bestaande client-server verbindingen om berichten te pushen en dus niet per bericht een nieuwe verbinding creëert. Dis is een veelgebruikt scenario als web-clients/applicaties moeten reageren op event streams die vliegensvlug updaten, zoals applicaties van aandelen brokers. De API Manager heeft de mogelijkheid om nieuwe op SSE-gebaseerde streaming API’s vanuit het niets te ontwerpen en om API’s te importeren met een ASyncAPI definitie. - Ondersteuning van het WebSub/WebHook protocol
WebSub is een ander eenrichtings-protocol waarmee de server events naar de geabonneerde clients pusht via HTTP POST naar een geregistreerde callback API. De API Manager faciliteert dit door op te treden als tussenpartij die de events naar de geregistreerde callback pusht wanneer er een update in de geabonneerde event stream plaatsvindt. Vergelijkbaar met de SSE en WebSocket API’s, kan ook de WebHook streaming API vanuit het niets ontwikkeld worden of geïmporteerd worden door middel van een ASyncAPI definitie.
Service Catalog
De Service Catalog, een catalogus van de services in de API Publisher, kan nu gebruikt worden om services (bijv. proxy services, REST API’s, enz.) te ontdekken. Services die ontworpen zijn door de Micro-Integrator of de Streaming-Integrator kunnen nu met minimale inspanning als een managed REST API of een streaming Streaming API opengesteld worden. De ingebouwde client in de Micro-integrator en Streaming-integrator producten publiceert informatie over de beschikbare gestelde services naar de geconfigureerde API Manager runtime. Met die gegevens wordt in de Service Catalog de essentiële informatie over een service getoond, zoals naam, versie, beschrijving, gebruik in API’s en de service definitie voor API-geleide integratie.
API Revisions
De functie voor API Revisions voegt een nieuwe dimensie toe aan API-versies. Het was al mogelijk om meerdere versies van een API te publiceren en nu krijgen de versies er met de WSO2 API Manager 4 nog een extra revisie-dimensie bij.
API Revisions heeft de optie om een revisie van een API uit te rollen, zonder het direct te publiceren op de gateway, zodat er extra tests uitgevoerd kunnen worden voordat de API door het brede publiek gebruikt wordt. Als er problemen ontstaan, kan de revisie teruggedraaid worden.
API Revisions is een manier om een API gefaseerd aan te passen, te testen en dan te publiceren of terug te trekken. Iedere API versie kan maximaal 5 revisies ondergaan en de API ontwikkelaar kan iedere revisie makkelijk terugdraaien door de ‘restore’-functie te gebruiken.
Conclusie
De WSO2 API Manager 4.0.0 is een flinke sprong vooruit in vergelijking met de voorgaande API Manager versie 3.2.0 op het gebied van architectuur en functionaliteit. Als enige product op de markt dat volledige end-to-end ondersteuning biedt voor event-driven architectures en streaming API’s en daarbij ook nog API-geleide integraties faciliteert, loopt het vooruit op het komende tijdperk van API Management. Yenlo zal de WSO2 APIM 4.0.0 aan zijn Connext Platform toevoegen om al deze nieuwe functies beschikbaar te maken. Bekijk de officiële WSO2 documentatie voor meer informatie over de WSO2 API Manager.
Neem contact met ons op om te bespreken hoe wij je kunnen helpen om IT-uitdagingen binnen jouw bedrijf op te lossen met WSO2-producten.
