Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info
Apigee Edge ist eine Plattform zum Entwickeln und Verwalten von APIs. Durch das Bereitstellen von Diensten mit einer Proxy-Ebene bietet Edge eine Abstraktion oder Fassade für Ihre Back-End-Dienst-APIs und bietet Sicherheit, Ratenbegrenzung, Kontingente, Analyse und mehr.
In diesem Webcast erfahren Sie beispielsweise, wie Walgreens APIs und Apigee Edge verwendet, um ein umfangreiches App-Ökosystem für Fotodrucke, Rezepte und andere Dienstleistungen bereitzustellen.
Erstellen Sie Ihren ersten Proxy!
Digitale Beschleunigung
Dieses Video bietet Ihnen einen schnellen Überblick, wie Apigee Sie bei der Weiterentwicklung eines digitalen Geschäfts unterstützt.
Zwischen der Dienstverwaltung und der API-Verwaltung wählen
Dieses Video zeigt die wichtigsten Unterschiede zwischen Dienstverwaltung und API-Verwaltung. Unternehmen.
Bereitstellung Ihrer Dienste im Web
Unternehmen möchten heute ihre Backend-Dienste im Web verfügbar machen, damit diese Dienste von Apps genutzt werden können, die auf Mobilgeräten und Desktop-Computern ausgeführt werden. Ein Unternehmen möchte Dienste verfügbar machen, die Produktpreise und Verfügbarkeitsinformationen, Verkaufs- und Bestelldienste, Bestellverfolgungsdienste und alle anderen von Clientanwendungen erforderlichen Dienste zur Verfügung stellen.
Unternehmen stellen oft Dienste als eine Reihe von HTTP-Endpunkten zur Verfügung. Entwickler von Clientanwendungen senden dann HTTP-Anfragen an diese Endpunkte. Je nach Endpunkt gibt der Dienst dann möglicherweise Daten im XML- oder JSON-Format an die Clientanwendung zurück.
Die Clientanwendungen, die diese Dienste nutzen, können als eigenständige Apps für Mobilgeräte oder Tablets, als HTML5-Apps im Browser oder als jede andere Art von Anwendung implementiert werden, die eine Anfrage an einen HTTP-Endpunkt stellen und Anwortdaten verarbeiten kann. Diese Anwendungen werden möglicherweise von demselben Unternehmen entwickelt und veröffentlicht, von dem die Dienste bereitgestellt werden, oder von Drittanbieteranwendungsentwicklern, die öffentlich verfügbare Dienste nutzen.
Die folgende Abbildung zeigt diesen Modelltyp:
Da Anbieter ihre Dienste über das Web zur Verfügung stellen, müssen sie sicherstellen, dass sie alle erforderlichen Maßnahmen ergriffen haben, um ihre Dienste vor unbefugtem Zugriff zu schützen. Berücksichtigen Sie als Dienstanbieter Folgendes:
- Sicherheit:Wie steuern Sie den Zugriff auf Ihre Dienste, um unbefugte Zugriffe zu verhindern?
- Kompatibilität:Funktionieren Ihre Dienste auf verschiedenen Plattformen und Geräten?
- Messbarkeit:Wie überwachen Sie Ihre Dienste, um sicherzustellen, dass sie verfügbar sind?
- Monetarisierung:Wie können Sie den Zugriff auf Ihre Dienste erfassen und Kunden in Rechnung stellen?
- Und viele andere Aspekte
Nachdem eine Clientanwendung veröffentlicht wurde, die auf Dienste zugreift, muss der Dienstanbieter sicherstellen, dass diese Dienste mit der Zeit weiter funktionieren, wenn sie weitere Dienste hinzufügen, ändern oder löschen. Der Dienstanbieter muss außerdem in der Lage sein, Anwendungsentwickler über Änderungen an den Diensten zu informieren, damit Clientanwendungen mit diesen Diensten synchron bleiben.
Clientanwendungsentwickler stehen vor Herausforderungen, wenn sie Dienste von verschiedenen Anbietern nutzen möchten. Dienstanbieter haben derzeit viele Technologien, um ihre Dienste verfügbar zu machen. Die gleiche Clientanwendung muss möglicherweise einen Mechanismus verwenden, um einen Dienst von einem Anbieter zu nutzen, und einen anderen Mechanismus, um einen Dienst von einem anderen Anbieter zu nutzen. Anwendungsentwickler können sogar mit verschiedenen Mechanismen konfrontiert werden, um Dienste desselben Anbieters zu nutzen.
Dienste über Apigee Edge verfügbar machen
Mit Apigee Edge können Sie unabhängig von der Implementierung des Dienstes einen sicheren Zugriff auf Ihre Dienste mit einer klar definierten API bieten, die unabhängig von der Dienstimplementierung konsistent ist. Eine konsistente API:
- Ermöglicht Anwendungsentwicklern die Nutzung Ihrer Dienste.
- Ermöglicht das Ändern der Implementierung des Backend-Dienstes, ohne die öffentliche API zu beeinträchtigen.
- Ermöglicht die Nutzung der Analyse-, Monetarisierungs-, Entwicklerportal- und anderer in Edge integrierten Funktionen.
In der folgenden Abbildung ist eine Architektur dargestellt, in der Edge die Anfragen von Clientanwendungen an die Backend-Dienste verarbeitet:
Anstatt dass App-Entwickler Ihre Dienste direkt nutzen, greifen sie auf einen API-Proxy zu, der in Edge erstellt wird. Der API-Proxy fungiert als Zuordnung eines öffentlich verfügbaren HTTP-Endpunkts zu Ihrem Backend-Dienst. Durch das Erstellen eines API-Proxys kann Edge die Sicherheits- und Autorisierungsaufgaben zum Schutz Ihrer Dienste verarbeiten und diese analysieren, überwachen und monetarisieren.
Da Anwendungsentwickler HTTP-Anfragen an einen API-Proxy und nicht direkt an Ihre Dienste senden, müssen Entwickler nichts über die Implementierung Ihrer Dienste wissen. Entwickler sollten wissen:
- Die URL des API-Proxy-Endpunkts.
- Alle Abfrageparameter, Header oder Textparameter, die in einer Anfrage übergeben werden.
- Alle erforderlichen Anmeldedaten für die Authentifizierung und Autorisierung
- Das Format der Antwort, einschließlich des Formats der Antwortdaten, z. B. XML oder JSON.
Der API-Proxy isoliert den App-Entwickler vom Backend-Dienst. Daher können Sie die Dienstimplementierung ändern, solange die öffentliche API konsistent bleibt. Durch die Aufrechterhaltung einer konsistenten Frontend-API funktionieren vorhandene Clientanwendungen weiterhin, unabhängig von Änderungen am Backend.
Sie können Richtlinien für den API-Proxy verwenden, um einem Dienst Funktionen hinzuzufügen, ohne Änderungen am Backend-Dienst vorzunehmen. Sie können beispielsweise Richtlinien zu Ihrem Proxy hinzufügen, um Datentransformationen und Filterungen durchzuführen, Sicherheit hinzuzufügen, eine bedingte Logik oder benutzerdefinierten Code auszuführen und viele weitere Aktionen auszuführen. Wichtig: Implementieren Sie Richtlinien auf Edge und nicht auf Ihrem Backend-Server.
Weitere Informationen finden Sie unter Informationen zu APIs und API-Proxys.
API-Produkt erstellen
Ein API-Proxy ist der HTTP-Endpunkt in Apigee Edge, mit dem Entwickler auf Ihre Backend-Dienste zugreifen. Obwohl es möglich ist, sind in der Regel keine einzelnen API-Proxys verfügbar. Stattdessen gruppieren Sie einen oder mehrere API-Proxys in einem API-Produkt.
Ein API-Produkt ist ein Paket mit API-Proxys in Kombination mit einem Serviceplan. Dieser Dienst kann Zugriffsbeschränkungen für API-Proxys festlegen, Sicherheit gewährleisten, Monitoring und Analysen ermöglichen sowie zusätzliche Funktionen bereitstellen. API-Produkte sind auch der zentrale Mechanismus, den Edge für die Autorisierung und Zugriffssteuerung für Ihre APIs verwendet.
Sie haben große Flexibilität bei der Erstellung von API-Produkten. Beispielsweise können mehrere API-Produkte denselben API-Proxy verwenden. Die folgende Abbildung zeigt drei API-Produkte. Beachten Sie, dass alle Produkte Zugriff auf API-Proxy 3 ermöglichen, aber nur Produkt A erlaubt Zugriff auf API-Proxy 1.
Sie können für jedes API-Produkt unterschiedliche Eigenschaften festlegen. Sie können beispielsweise ein API-Produkt mit einer niedrigen Zugriffsbeschränkung, z. B. 1.000 Anfragen pro Tag, zu einem Sonderpreis anbieten. Anschließend veröffentlichen Sie ein anderes API-Produkt, das Zugriff auf denselben API-Proxy, jedoch mit einem viel höheren Zugriffsbeschränkungen zu einem höheren Preis bietet. Alternativ können Sie ein kostenloses API-Produkt erstellen, das schreibgeschützten Zugriff auf Ihre Dienste ermöglicht, und dann ein API-Produkt an dieselben API-Proxys verkaufen, die Lese- und Schreibzugriff erlauben.
Weitere Informationen finden Sie unter API-Produkte verwalten.
Clientseitige Anwendung auf das API-Produkt zugreifen lassen
Wenn Anwendungsentwickler entscheiden, auf Ihre Dienste zuzugreifen, müssen sie ihre Clientanwendung zuerst bei Ihrem API-Produkt registrieren.
Bei der Registrierung erhält ein Anwendungsentwickler einen API-Schlüssel, den er in jede Anfrage an einen API-Proxy des API-Produkts aufnehmen muss. Dieser Schlüssel wird authentifiziert. Wenn die Authentifizierung erfolgreich ist, kann die Anfrage auf den Backend-Dienst zugreifen.
Sie können den Schlüssel jederzeit widerrufen, damit die Clientanwendung keinen Zugriff mehr auf Ihre Dienste hat. Alternativ können Sie ein Zeitlimit für einen Schlüssel definieren, sodass der Entwickler den Schlüssel nach einer bestimmten Zeit aktualisieren muss.
Sie entscheiden, wie Sie Registrierungsanfragen von Entwicklern bearbeiten, um auf Ihre API-Produkte zuzugreifen. Mit den Apigee Edge Developer-Diensten können Sie den Registrierungsprozess automatisieren. oder Sie können den Zugriff manuell steuern.
API-Produkte erstellen und Entwicklern zur Verfügung stellen
- Erstellen Sie einen oder mehrere API-Proxys, die öffentlich verfügbaren URLs Ihren Backend-Diensten zuordnen.
- Erstellen Sie ein API-Produkt, das Ihre API-Proxys bündelt.
- Stellen Sie Ihre API-Proxys und das API-Produkt bereit.
- Informieren Sie Ihre Entwickler, dass das API-Produkt verfügbar ist.
Wenn Anwendungsentwickler etwas über die Verfügbarkeit Ihres API-Produkts wissen, tun sie Folgendes:
- Registrieren Sie die Clientanwendungen Ihres API-Produkts.
- Sie erhalten einen API-Schlüssel für das API-Produkt.
- Senden Sie Anfragen an Ihre Dienste über API-Proxys, die im API-Produkt enthalten sind, und übergeben Sie den API-Schlüssel mit jeder Anfrage.
Komponenten von Apigee Edge
Apigee Edge besteht aus API-Laufzeit, -Monitoring und -Analyse sowie Entwicklerdiensten, die eine umfassende Infrastruktur für die Erstellung, Sicherheit, Verwaltung und den Betrieb von APIs bieten.
Die folgende Abbildung zeigt Edge-Dienste:
Edge API-Laufzeit
Bei Apigee Edge API-Diensten geht es darum, APIs zu erstellen und zu nutzen, unabhängig davon, ob Sie API-Proxys als Dienstanbieter erstellen oder APIs, SDKs und andere praktische Dienste als Anwendungsentwickler verwenden.
Der API-Verwaltungsserver bietet Tools zum Hinzufügen und Konfigurieren Ihrer API-Proxys, zum Einrichten von API-Produkten sowie zum Verwalten von Anwendungsentwicklern und Clientanwendungen. Es entfernt viele häufige Verwaltungsprobleme von Ihren Backend-Diensten. Wenn Sie einen API-Proxy hinzufügen, können Sie Richtlinien auf den API-Proxy anwenden, um Sicherheit, Ratenbegrenzung, Mediation, Caching usw. hinzuzufügen. Sie können das Verhalten Ihres API-Proxys auch anpassen, indem Sie benutzerdefinierte Skripts anwenden, Aufrufe an APIs und Dienste von Drittanbietern senden usw. Weitere Informationen finden Sie unter Informationen zu APIs und API-Proxys.
Als Node.js-Entwickler können Sie Ihre Node.js-Module nahtlos zu Edge hinzufügen, um APIs und API-Mashups zu erstellen und dabei die Vorteile von Edge zu nutzen, von der Nachrichtentransformation über die Sicherheit bis hin zu Analysen.
Edge-Monitoring und ‑Analysen
Apigee Edge API Analytics bietet leistungsstarke Tools, um kurze und langfristige Nutzungstrends Ihrer APIs zu sehen. Sie können Ihre Zielgruppe nach den wichtigsten Entwicklern und Anwendungen segmentieren, die Nutzung nach API-Methode verstehen, um zu ermitteln, wo sich Investitionen lohnen, und benutzerdefinierte Berichte mit Informationen auf Unternehmens- oder Betriebsebene erstellen.
Bei der Übertragung von Daten über Edge werden verschiedene Standardtypen von Informationen erfasst, einschließlich URL, IP, Nutzer-ID für API-Aufrufinformationen, Latenz, Fehlerdaten usw. Sie können Richtlinien erstellen, um andere Informationen wie Header, Abfrageparameter und Teile einer aus XML oder JSON extrahierten Anfrage oder Antwort hinzuzufügen. Diese Informationen werden asynchron aus dem Anfrage-/Antwort-Ablauf erfasst und haben daher keine Auswirkungen auf die API-Leistung.
Über die Verwaltungsoberfläche können Sie mehrere Messwerte und Dimensionen in einem Browser anzeigen, wie in der folgenden Abbildung dargestellt:
Sie können den Dienst aber auch über eine Befehlszeile oder über RESTful APIs aufrufen und steuern. Weitere Informationen finden Sie unter Übersicht über API Analytics.
Edge-Entwicklerumgebung
Apigee Edge bietet Entwicklerdienste, die Ihnen Folgendes ermöglichen:
- Verwalten Sie die Community von Anwendungsentwicklern, die Ihre Dienste verwenden.
- Arbeiten Sie mit internen und externen Entwicklern zusammen und formulieren Sie die Beziehungen zu Finanzmodellen.
- Laden Sie Entwickler ein und erstellen Sie ein Entwicklerportal. App-Entwickler stellen eine Verbindung zu Ihrem Portal her, um auf die API-Dokumentation zuzugreifen und mehr über Ihre öffentlich verfügbaren API-Produkte und die Verwaltung von API-Schlüsseln zu erfahren.
Jeder Edge-Kunde kann sein eigenes Entwicklerportal erstellen, entweder in der Cloud oder lokal mit Apigee Edge for Private Cloud.
Mit Apigee Edge können Sie zwei Arten von Portalen erstellen:
- Integriertes Portal, das sofort bereitgestellt werden kann. Weitere Informationen finden Sie unter Eingebundenes Portal erstellen.
- Drupal-basiertes Portal Weitere Informationen finden Sie unter Drupal-basiertes Portal erstellen.
Monetarisierung
Monetarisierungsfunktionen bieten die finanzielle Infrastruktur und die Beziehungen, um Ihre Entwickler-Community in einen echten Kanal für Ihre digitalen Assets zu verwandeln. Mit der Monetarisierung können Sie verschiedene Tarifpakete erstellen, bei denen Entwicklern die Nutzung Ihrer API-Produkte in Rechnung gestellt wird oder Sie Entwicklern eine Umsatzbeteiligung zahlen.
Zu den Tarifen gehören Prepaid-, Postpaid-, Festpreis-, variable Tarife, Freemium-Tarife, auf bestimmte Entwickler zugeschnittene Tarife und Tarife für Entwicklergruppen. Außerdem gehören zur Monetarisierung Berichts- und Abrechnungsfunktionen.
Weitere Informationen finden Sie unter Monetarisierung – Übersicht.
Edge-Varianten
Apigee Edge gibt es in folgenden Flavors:
- Öffentliche Cloud: Eine gehostete SAAS-Version, in der Apigee die Umgebung verwaltet. So können Sie sich auf den Aufbau Ihrer Dienste konzentrieren und die APIs für diese Dienste definieren.
- Private Cloud: Eine On-Premises-Installation, bei der Sie die Hardwareumgebung steuern und für die Installation, das Upgrade, die Wartung und andere administrative Prozesse verantwortlich sind.
Wenn Sie an unserer Apigee Hybrid-Version interessiert sind, lesen Sie die folgenden Apigee X-Themen:
Funktionell sind die Public-Cloud- und Private-Cloud-Versionen sehr ähnlich. Die Private Cloud-Version unterstützt jedoch nicht alle Funktionen der Public Cloud-Version. Von Private Cloud nicht unterstützte Funktionen:
- Gehostete Ziele
- Erweiterungen
- Integrierte Entwicklerportale (Hinweis: Drupal-basierte Entwicklerportale werden unterstützt)
- API-Monitoring
- Sense
Eine Liste der Unterschiede zwischen den Versionen finden Sie unter Apigee-Produkte vergleichen.
Außerdem gibt es geringfügige Unterschiede zwischen den APIs, die im Abschnitt Unterschiede zwischen der Edge for Public Cloud API und der Private Cloud API beschrieben werden.
Die Public Cloud unterstützt sowohl kostenlose als auch kostenpflichtige Konten. Für die Private Cloud sind kostenpflichtige Konten erforderlich.
Zur vollständigen Unterstützung einer lokalen Installation enthält die Private Cloud-Version Komponenten wie den Apigee-Verwaltungsserver, eine Apache Cassandra-NoSQL-Datenbank, einen OpenLDAP-Server, einen Nachrichten-Router und einen Nachrichten-Prozessor.