Eigenständiger BegriffMusterKapitel II · Kommunikation · Baustein 20 von 23

API Gateway

Ein API Gateway nimmt externe Anfragen an und leitet sie anhand veröffentlichter Routen an interne Ziele weiter.

  1. Externer VertragStabile Route, Methode und Fehlerform für Clients.
  2. RandkontrolleTLS, Identität, Rate Limit und Deadline konsistent anwenden.
  3. WeiterleitungErreichbares Ziel wählen und Korrelation erhalten.

Einordnung

Warum das wichtig ist

Das Gateway besitzt Randaufgaben wie TLS, Authentifizierung, Rate Limits und Routing; fachliche Regeln und lang laufende Prozesszustände bleiben dahinter.

Die verteilte Ausbaustufe im Shop-Szenario ist hypothetisch; der aktuelle Shop bleibt ein modularer Monolith mit sieben Modulen und gemeinsamer Datenbank.

Shop-Beispiel · Zuordnung

API Gateway: Entscheidungsgrenzen

Der aktuelle Shop bleibt ein modularer Monolith mit sieben Modulen. Hypothetisch erhalten Browser und Kundenservice über ein Gateway getrennte öffentliche Routen zu Katalog und Versand. Das Gateway prüft Identität, Rate Limit und Deadline und leitet an registrierte Ziele weiter. Das Team simuliert ein nicht erreichbares Ziel und eine ungültige Berechtigung und belegt eindeutige Statuscodes, Korrelations-ID, begrenzte Wiederholung und unveränderte interne Verträge.

So liest du das Bild

  1. Externer Vertrag Öffentliche Route
  2. Randkontrolle Gemeinsame Policy
  3. Weiterleitung Discovery plus Timeout
API Gateway: Entscheidungsgrenzen
VergleichAspektTragfähiger EinsatzGrenze
RoutingMehrere interne Ziele hinter stabilem EinstiegRouten versioniert und beobachtetFehlroute oder Schleife belastet alle Clients
RandkontrolleGemeinsame ZugangspolitikZentral geprüft und auditiertGateway wird kritische Kapazitätsgrenze
AggregationWenige Aufrufe mit fester DeadlineClient spart RoundtripsFan-out und Teilfehler bleiben sichtbar
Die Matrix verbindet Nutzen, Verantwortung und Grenze.

Nutzen & Grenzen

Hilft, wenn

  • Routen versioniert und beobachtet
  • Zentral geprüft und auditiert
  • Client spart Roundtrips

Grenzen

  • Fehlroute oder Schleife belastet alle Clients
  • Gateway wird kritische Kapazitätsgrenze
  • Fan-out und Teilfehler bleiben sichtbar

In der Praxis

  1. Lege externe Routen für Produktabfrage und Versandstatus fest. Prüfe, dass Clients nur öffentliche Verträge kennen und interne Adressen austauschbar bleiben.
  2. Sende eine nicht autorisierte Anfrage und simuliere ein nicht erreichbares Ziel. Verfolge Ablehnung, Timeout und Korrelationskennung über Gateway und Ziel.
  3. Bewerte, welche Funktionen am Gateway zentral bleiben dürfen. Prüfe, ob fachliche Aggregation oder dauerhafte Ablauflogik eine andere Komponente braucht.
Ausführliche Erklärung lesen

Clients kennen einen stabilen externen Vertrag, während interne Ziele wechseln können. Das Gateway authentifiziert, autorisiert die Route, setzt ein Zeitbudget und übergibt Korrelation an das Ziel.

Zentrale Randfunktionen vereinfachen Konsistenz, machen Kapazität und Konfiguration des Gateways aber kritisch. Aggregation darf nur mit klarer Deadline erfolgen; dauerhafte Fachabläufe gehören in einen eigenen Koordinator.

Backend for Frontend formt Verträge für Clientfamilien. Service Discovery liefert dem Gateway erreichbare interne Ziele.

Selbst prüfen

Teste dich in drei Stufen

  1. AblesenIm Bild nachsehen

    Was ist die Kernaufgabe von API Gateway?

    Lösung mit Begründung ansehen

    Ein API Gateway nimmt externe Anfragen an und leitet sie anhand veröffentlichter Routen an interne Ziele weiter.

  2. AnwendenAuf eine neue Lage übertragen

    Welche Annahme ist im Shop hypothetisch?

    Lösung mit Begründung ansehen

    Hypothetisch erhalten Browser und Kundenservice über ein Gateway getrennte öffentliche Routen zu Katalog und Versand. Das Gateway prüft Identität, Rate Limit und Deadline und leitet an registrierte Ziele weiter.

  3. BewertenEine Alternative abwägen

    Welche drei Punkte müssen vor einer Einführung belegt sein?

    Lösung mit Begründung ansehen

    Externer Vertrag, Randkontrolle, Weiterleitung.

Weiter im Lernpfad

Als Nächstes in Kommunikation & APIs: Backend for Frontend.