Glossar

Diese Seite enthält kurze Definitionen und Links zu weiteren Informationen für die Begriffe, die in der API Gateway-Dokumentation verwendet werden.

API
Eine REST-Schnittstelle, mit der eine Anwendung problemlos Funktionen oder Daten aus einer anderen Anwendung nutzen kann. Durch die Definition von stabilen, einfachen und gut dokumentierten Einstiegspunkten können Entwickler dank APIs auf die von anderen Entwicklern erstellte Anwendungslogik zugreifen und diese wiederverwenden.
API-Konfiguration
Wird erstellt, wenn Sie eine API-Definition in API Gateway hochladen. Jedes Mal, wenn Sie eine API-Definition hochladen, erstellt API Gateway eine neue API-Konfiguration. Das heißt, Sie können eine API-Konfiguration erstellen, aber später nicht mehr ändern. Wenn Sie die API-Definition später bearbeiten und dann die bearbeitete API-Definition hochladen, erstellen Sie eine neue API-Konfiguration.
API-Definition
Eine Open API 2.0-Spezifikation oder gRPC-Konfiguration, die zum Erstellen einer API-Konfiguration verwendet wird. Eine API-Definition gibt Folgendes an: die URL des Back-End-Dienstes, das Datenformat der Daten, die in einer Anfrage übergeben werden, das Datenformat aller vom Dienst zurückgegebenen Daten, den Authentifizierungsmechanismus zur Steuerung des Zugriffs auf den Dienst und viele weitere Optionen.
API-Schlüssel
Ein Code, der von einer Clientanwendung beim Aufrufen einer API übergeben wird. API-Schlüssel identifizieren die Anwendung oder das Google Cloud-Projekt, das den Aufruf der API durchführt. Weitere Informationen zur Verwendung eines API-Schlüssels mit Ihrer API Gateway API finden Sie unter API-Schlüssel effizient nutzen.
Auth0
Ein Dienst, mit dem Sie festlegen können, wie sich Nutzer bei Anwendungen authentifizieren. Weitere Informationen finden Sie unter Auth0.
CORS
Cross-Origin Resource Sharing (CORS) ist eine Spezifikation, mit der Webanwendungen auf Ressourcen zugreifen können, die sich auf einem Server in einer anderen Domain (technisch betrachtet also mit anderer Herkunft) befinden. Weitere Informationen zu CORS finden Sie in den Webdokumenten für Mozilla Developer Network (MDN) und unter Fetch Living Standard.
Firebase Authentication
Der Authentifizierungsdienst von Google, der die Endnutzeranmeldung für Clientanwendungen mit Anmeldedaten von den großen föderierten Identitätsanbietern wie Google, Facebook oder Twitter unterstützt. Weitere Informationen finden Sie unter Firebase-Authentifizierung.
Gateway
Ein leistungsstarker, skalierbarer Proxy, der auf Envoy basiert und auf dem die bereitgestellte API-Konfiguration gehostet wird. Durch das Erstellen eines Gateways wird die externe URL erstellt, über die Ihre API-Clients auf die API zugreifen. Ein Gateway hostet nur eine einzelne API-Konfiguration. Es ist nicht möglich, mehrere API-Konfigurationen für dasselbe Gateway bereitzustellen.
Google-ID-Token
Ein JSON Web Token (JWT), das die erforderlichen OpenID Connect-Felder zur Identifizierung eines Google-Nutzerkontos oder -Dienstkontos enthält und das vom Google-Authentifizierungsdienst https://accounts.google.com signiert ist.
gRPC
Ein von Google entwickeltes allgemeines und besonders leistungsfähiges RPC-Open-Source-Framework. In gRPC kann eine Clientanwendung Methoden in einer Serveranwendung auf einem anderen Computer direkt aufrufen, als wäre sie ein lokales Objekt. Informationen zur Verwendung von gRPC mit API Gateway finden Sie unter gRPC – Übersicht. Allgemeine Informationen finden Sie auf der gRPC.
JWT
JSON Web Token ist ein Tokenformat mit offenem Standard für die Verwendung in HTTP-Autorisierungs-Headern und URI-Abfrageparametern. Allgemeine Informationen finden Sie unter Einführung in JSON Web Tokens.
OpenAPI
Die OpenAPI-Initiative ist eine branchenweite Initiative zur Standardisierung der Beschreibung von REST APIs. Mit der OpenAPI-Spezifikation (früher Swagger-Spezifikation) beschriebene APIs können durch gängige Tools zum Erstellen von Dokumentationen, zum Automatisieren von Tests oder zum Generieren von Code für Clients und Server unterstützt werden. Weitere Informationen finden Sie in der OpenAPI-Übersicht.
OpenAPI-Dokument
Eine Datei im YAML- oder JSON-Format, mit der Sie Ihre API beschreiben. Diese Datei wird auch als API-Definition bezeichnet. Beim Hochladen in API Gateway wird das OpenAPI-Dokument in eine API-Konfiguration umgewandelt.
Oberfläche
Die öffentliche Schnittstelle einer API. Die Oberfläche einer API besteht aus den Methoden sowie den in den Methoden verwendeten Parametern und Rückgabetypen.