Seminar Gravitee Event-Native API Management und AsyncAPI

Das Seminar vermittelt die Verwaltung synchroner und asynchroner Schnittstellen auf einer gemeinsamen Gravitee-Plattform. Message APIs, Protokollvermittlung, Streaming-Entrypoints, Ereignis-Broker, AsyncAPI-Dokumentation und message-basierte Policies werden anhand praxisnaher Integrationsketten umgesetzt.

Inhaltsübersicht

• Seminarziele
• Inhalte
• Praxisübungen
• Zielgruppe
• Voraussetzungen
• Arbeitsweise

Seminarziele

Im Seminar werden folgende Kompetenzen aufgebaut:

• Event-driven Integrationen und Event APIs fachlich sowie technisch modellieren
• V4-Message-APIs mit geeigneten Entrypoints und Endpoints konfigurieren
• HTTP, WebSocket, Webhook und SSE mit Kafka, MQTT, RabbitMQ, Solace oder JMS vermitteln
• Qualitäts-, Liefer- und Subscription-Anforderungen nachvollziehbar festlegen
• Nachrichten auf Gateway-Ebene schützen, filtern, transformieren und beobachten
• AsyncAPI-Dokumentation und Developer-Portal-Veröffentlichung in den Lifecycle integrieren

Inhalte

Event-Native-Grundmodell

• Events, Commands, Streams und klassische Request-Response-APIs
• Producer, Consumer, Broker, Topic, Queue und Subscription
• Event API als kontrolliertes Produkt
• Abgrenzung Message API, Native Kafka API und Federation

V4-Message-API-Architektur

• Listener, Entrypoints, Endpoints und Gateway-Verbindungen
• Publish-, Subscribe- und Interaktionsmuster
• HTTP GET, HTTP POST, WebSocket, Webhook und Server-Sent Events
• Persistente Verbindungen, Heartbeats und Client-Identität

Broker und Protokollvermittlung

• Kafka-, MQTT-5-, RabbitMQ-, Solace- und JMS-Endpoints
• Producer-, Consumer- und bidirektionale Konfiguration
• Topic- und Queue-Auswahl, Credentials, TLS und SASL
• Synchroner Zugriff auf Ereignisquellen und ereignisbasierte Zustellung an HTTP-Consumer

Lieferqualität und Fehlerpfade

• Quality of Service und passende Zustellsemantik
• Webhook-Callbacks, Wiederholungen und Dead-Letter-Verfahren
• Backpressure, Latenz, Timeouts und Consumer-Abbruch
• Response Templates und kontrollierte technische Fehlerantworten

Message Policies und Sicherheit

• Message-Phasen, Flows und planbezogene Regeln
• Filterung, Transformation, Header- und Attributzuweisung
• Rate Limits, Zugriffsschutz und Mandantentrennung
• Shared Policy Groups für wiederverwendbare Event-Guardrails

AsyncAPI und Portal

• Channels, Operations, Messages, Schemas und Bindings
• Dokumentation von Producing, Consuming, Fehlern und Service Levels
• Veröffentlichung, Anwendungen und Subscriptions
• Consumer-Onboarding für Streaming- und Callback-Szenarien

Analyse und Betrieb

• Connection-, Message- und Webhook-Logs
• Metriken, Dashboards, Reporter und Traces
• Fehlersuche bei Broker-Verbindung, Credentials und Zustellung
• Kapazitäts- und Betriebsaspekte persistenter Verbindungen

Praxisübungen

1. Eine V4-Message-API mit Broker-Endpoint und HTTP-Entrypoint erstellen.
2. Ein Ereignis über HTTP veröffentlichen und über WebSocket oder SSE konsumieren.
3. Eine Webhook-Subscription mit Wiederholung und kontrolliertem Fehlerpfad konfigurieren.
4. Nachrichten filtern, Attribute zuweisen und Payloads transformieren.
5. Eine AsyncAPI-Beschreibung ergänzen und im Developer Portal bereitstellen.
6. Verbindungs-, Zustell- und Policy-Fehler anhand von Logs und Metriken diagnostizieren.

Zielgruppe

Integrationsentwickler, Event- und API-Architekten, Platform Engineers, Kafka- beziehungsweise Messaging-Teams und technische Product Owner.

Voraussetzungen

Gravitee-APIM-Grundkenntnisse sowie Grundlagen zu Messaging, Topics, Queues und JSON; Broker-Erfahrung ist hilfreich.

Arbeitsweise

Die Themen werden durch fachliche Einordnung, Demonstrationen und aufeinander aufbauende Übungen am System vermittelt. Konfigurationen werden geprüft, mit Negativtests belastet und anhand von Logs, Statusinformationen oder Metriken nachvollzogen. Die Übungen bilden einen durchgängigen technischen Anwendungsfall und vermeiden isolierte Klickfolgen ohne betrieblichen Zusammenhang.