API-Gateway

Ein API-Gateway ist ein Reverse-Proxy, der speziell für APIs entwickelt wurde. Clients rufen das Gateway auf; dieses entscheidet, welcher Backend-Dienst die Anfrage bearbeitet und wendet die übergreifenden Regeln an, die jeder Dienst sonst selbst implementieren würde – Authentifizierung, Kontingente, Beschränkungen der Anfragegröße, CORS, Anfrage-IDs, Caching und Metriken.

So funktioniert es

Routen ordnen Pfade und Methoden vorgelagerten Diensten zu. Richtlinien werden vor und nach dem Aufruf des vorgelagerten Dienstes ausgeführt: Token verifizieren, Ratenbegrenzung prüfen, Anfrage weiterleiten, Header hinzufügen und protokollieren. Da sich das Gateway im Pfad befindet, stammen viele Fehler, die ein Client sieht – 401, 413, 429, 502, 504 – vom Gateway und nicht vom Dienst, den der Client aufrufen wollte.

Das Missverständnis

Ob ein 502- oder 504-Fehler auf einen Fehler der Anwendung zurückzuführen ist oder nicht, hängt vom Gateway ab: 502 bedeutet, dass der Dienst mit einer ungültigen Antwort reagiert oder die Verbindung abgebrochen hat, 504, dass er nicht rechtzeitig geantwortet hat. Die Gateway-Protokolle und die Anforderungs-ID sind ein guter Ausgangspunkt für die Fehlersuche.

Probieren Sie es hier aus

GET /protocol/v1/gateway-timeout verhält sich wie ein Gateway vor einem langsamen Upstream und antwortet nach etwa drei Sekunden mit dem Statuscode 504; GET /faults/v1/status/502 gibt auf Anfrage den Fall eines fehlerhaften Gateways zurück.

Quellen

Weitere Begriffe

Diese Seite auf Englisch lesen

Alle Glossarbegriffe · Testtechniken · Alle 39 Mock-REST-APIs

Zuletzt aktualisiert