Informationen zu APIs und API-Proxys

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

Mit Apigee Edge können Sie schnell und einfach RESTful APIs erstellen, die von App-Entwicklern genutzt werden können. Sie machen APIs auf Edge verfügbar, indem Sie API-Proxys erstellen, die als verwaltete "Fassaden" für Back-End-Dienste dienen. In diesem Thema wird die Beziehung zwischen APIs und API-Proxys in Apigee Edge erläutert.

Video: In diesem kurzen Video erhalten Sie eine Einführung in API-Proxys.

Was ist eine API?

Eine API ist eine Schnittstelle, mit der eine Anwendung problemlos Funktionen oder Daten aus einer anderen Anwendung nutzen kann. Durch die Definition stabiler, vereinfachter Einstiegspunkte für Anwendungslogik und -daten können Entwickler auf die von anderen Entwicklern erstellte Anwendungslogik zugreifen und diese wiederverwenden. Bei Web-APIs werden diese Logik und Daten über das Netzwerk bereitgestellt.

Da Anwendungen, die APIs verwenden, auf Änderungen empfindlich reagieren, schließen APIs auch einen "Vertrag" ein. Der Vertrag sorgt für ein gewisses Maß an Sicherheit, dass sich die API im Laufe der Zeit auf vorhersehbare Weise verändert.

Mit Apigee Edge können Sie APIs erstellen. Wenn Sie bereits APIs haben, können Sie diese direkt verfügbar machen und gleichzeitig eine Verwaltungs- und Sichtbarkeitsebene hinzufügen. HTTP-fähige Dienste wie SOA-basierte Webdienste können auch als APIs über Apigee Edge verfügbar gemacht werden.

Edge ermöglicht es Ihnen auch, APIs zu erstellen, indem Sie Anwendungen implementieren, die auf der API-Dienstplattform gehostet werden, ohne dass ein Back-End-Dienst erforderlich ist. Sie können diese Anwendungen in JavaScript, Java und Node.js erstellen.

Was ist ein API-Proxy?

Sie machen APIs auf Apigee Edge verfügbar, indem Sie API-Proxys implementieren. API-Proxys entkoppeln die API für die Anwendung von Ihren Back-End-Diensten und schützen diese Anwendungen vor Back-End-Codeänderungen. Wenn Sie Back-End-Änderungen an Ihren Diensten vornehmen, rufen die Anwendungen weiterhin dieselbe API auf, ohne dass es zu Unterbrechungen kommt.

In einer API-Proxy-Konfiguration gibt es zwei Arten von Endpunkten:

  • ProxyEndpoint: Legt fest, wie Client-Apps Ihre APIs verwenden. Sie konfigurieren den ProxyEndpoint, um die URL Ihres API-Proxys zu definieren. Der Proxy-Endpunkt bestimmt auch, ob Anwendungen über HTTP oder HTTPS auf den API-Proxy zugreifen. In der Regel hängen Sie Richtlinien an den ProxyEndpoint an, um Sicherheit, Kontingentprüfungen und andere Arten der Zugriffssteuerung und Ratenbegrenzung zu erzwingen.
  • TargetEndpoint:Definiert die Art und Weise, wie der API-Proxy mit Ihren Back-End-Diensten interagiert. Sie konfigurieren TargetEndpoint so, dass Anfragen an den richtigen Back-End-Dienst weitergeleitet werden. Dabei legen Sie Sicherheitseinstellungen, das HTTP- oder HTTPS-Protokoll und andere Verbindungsinformationen fest. Sie können dem TargetEndpoint Richtlinien hinzufügen, damit die Antwortnachrichten für die Anwendung, die die ursprüngliche Anfrage gesendet hat, ordnungsgemäß formatiert sind.

Sie können API-Proxys wie in der folgenden Grafik dargestellt visualisieren:

HTTP-Anfragen werden über den Endpunkt der Proxy-Anfrage eingegeben, an den Ziel-Anfrageendpunkt übergeben und dann an die Back-End-Dienste gesendet. HTTP-Antworten werden über den Zielantwortendpunkt eingegeben, an den Proxy-Antwortendpunkt und dann zurück an den Client übergeben.

Wie erstellen Sie einen API-Proxy?

Ein API-Proxy besteht aus einem Set von XML-Konfigurationsdateien und Code (z. B. JavaScript und Java). Apigee bietet mehrere Möglichkeiten zum Erstellen von API-Proxys, z. B.:

  • Verwenden der Edge-Management-Benutzeroberfläche, um einen API-Proxy in einer grafischen Benutzeroberfläche (GUI) zu definieren. Weitere Informationen finden Sie unter Einfachen API-Proxy erstellen.
  • Erstellen von XML-Dateien zusammen mit anderen unterstützenden Dateien, die Ihren API-Proxy definieren, und importieren Sie sie dann in Edge.
  • Verwenden der Edge-Verwaltungs-API zum Erstellen Ihrer API-Proxys durch Senden einer Reihe von REST-Anfragen an Edge.
  • Stellen Sie eine Node.js-Anwendung als Proxy bereit. Siehe Eigenständige Node.js-Anwendung bereitstellen.

Was ist eine Richtlinie?

Mit Edge können Sie das API-Verhalten mithilfe von Richtlinien steuern, ohne Code schreiben zu müssen. Eine Richtlinie ist wie ein Modul, das eine bestimmte, eingeschränkte Verwaltungsfunktion als Teil des Proxy-Anfrage-/-Antwortablaufs implementiert. Mithilfe von Richtlinien können Sie gängige Verwaltungsoptionen einfach und zuverlässig auf APIs anwenden. Richtlinien bieten Funktionen wie Sicherheits-, Ratenbegrenzungs-, Transformations- und Vermittlungsfunktionen. Sie müssen dann nicht mehr Code schreiben und diese Funktionen selbst verwalten.

Ersten API-Proxy erstellen

Apigee bietet eine Reihe von Anleitungen, mit denen Sie Ihre erste API erstellen können. Beginnen Sie mit Ersten API-Proxy erstellen.

Eine gute Möglichkeit, sich über API-Proxys zu informieren, ist die Arbeit mit den Beispielen, wie unter Verwenden der Beispiel-API-Proxys beschrieben.

Weitere Informationen