Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info
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 Backend-Dienste fungieren. In diesem Thema wird die Beziehung zwischen APIs und API-Proxys auf 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 und bereits vorhandene direkt verfügbar machen, und gleichzeitig eine Verwaltungs- und Sichtbarkeitsebene hinzufügen. Wenn Sie HTTP-fähige Dienste haben, z. B. SOA-basierte Webdienste, können diese auch als APIs über Apigee Edge verfügbar gemacht werden.
Mit Edge können Sie APIs auch erstellen, indem Sie Anwendungen implementieren, die auf der API Services Plattform gehostet sind, und zwar ohne Back-End-Dienst. 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 App-seitige API von Ihren Backend-Diensten, sodass diese Apps von Änderungen am Backend-Code abgeschirmt sind. Auch wenn Sie im Backend Änderungen an Ihrem Dienst vornehmen, rufen die Apps weiterhin dieselbe API auf – ohne Unterbrechung.
In einer API-Proxykonfiguration 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, wie der API-Proxy mit Ihren Backend-Diensten interagiert. Sie konfigurieren den TargetEndpoint so, dass Anfragen an den richtigen Backend-Dienst weitergeleitet werden, einschließlich der Festlegung von Sicherheitseinstellungen, HTTP- oder HTTPS-Protokoll und anderen Verbindungsinformationen. 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 Abbildung dargestellt visualisieren:
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.:
- Edge-Verwaltungs-UI zum Definieren eines API-Proxys in einer grafischen Benutzeroberfläche (GUI) verwenden. Weitere Informationen finden Sie unter Einfachen API-Proxy erstellen.
- XML-Dateien zusammen mit allen anderen unterstützenden Dateien erstellen, die Ihren API-Proxy definieren, und dann in Edge importieren.
- Edge-Verwaltungs-API zum Erstellen der API-Proxys nutzen, um eine Reihe von REST-Anfragen an Edge zu senden.
- Eine Node.js-Anwendung als Proxy bereitstellen Weitere Informationen finden Sie unter Standalone-Node.js-Anwendung bereitstellen.
Was ist eine Richtlinie?
Edge gibt Ihnen die Möglichkeit, das API-Verhalten zu steuern, ohne Code zu schreiben – einfach über policies. 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, mehr über API-Proxys zu erfahren, ist die Arbeit mit den Beispielen, wie unter Beispiel-API-Proxys verwenden beschrieben.