Veröffentlichen – Übersicht

Sie lesen die Dokumentation zu Apigee X.
Apigee Edge-Dokumentation aufrufen

Beim Veröffentlichen werden Ihre APIs App-Entwicklern zur Nutzung zur Verfügung gestellt.

Video: Das folgende Video bietet eine allgemeine Einführung in die API-Veröffentlichung.

Das Veröffentlichen von APIs umfasst die folgenden Aufgaben, die in diesem Thema beschrieben werden:

  1. Erstellen Sie die API-Produkte, die Ihre APIs bündeln.
  2. Anwendungsentwickler registrieren
  3. Registrieren Sie Entwickleranwendungen
  4. Stellen Sie Dokumentations- und Community-Support für Ihre APIs zur Verfügung.

Aufgabe 1: API-Produkt erstellen

Die erste Aufgabe bei der Veröffentlichung ist die Erstellung eines API-Produkts. Ein API-Produkt ist eine Sammlung von API-Ressourcen, die Anwendungsentwicklern als Paket angeboten wird. Erstellen Sie API-Produkte mithilfe der Apigee API oder Benutzeroberfläche. (Weitere Informationen zu API-Produkten finden Sie unter Was ist ein API-Produkt?).

Ein Diagramm mit der Schreibrichtung von links nach rechts, das einen Entwickler, eine Anwendung, APIs und Back-End-Dienste zeigt. Das API-Symbol und die Ressourcen werden hervorgehoben. Eine gestrichelte Linie weist den Entwickler auf ein Symbol einer vom Entwickler erstellten Anwendung hin. Pfeile von und zurück zur Anwendung zeigen den Anfrage- und Antwortablauf auf ein API-Symbol, wobei der Anwendungsschlüssel über der Anfrage positioniert wird. Das API-Symbol und die Ressourcen werden hervorgehoben. Unter dem API-Symbol befinden sich zwei Gruppen von Ressourcenpfaden, die in zwei API-Produkte gruppiert sind: Standortprodukt und Medienprodukt.
    Das StandortProdukt enthält Ressourcen für /Länder, /Städte und /Sprachens und das Media-Produkt enthält Ressourcen für /Bücher, /Magazine und /Filme. Rechts neben der API befinden sich die Back-End-Ressourcen, die von der API aufgerufen werden, darunter eine Datenbank, ein Unternehmensdienstbus, Anwendungsserver und ein generisches Back-End.

In dieser Abbildung besteht die API aus zwei Produkten mit jeweils drei API-Ressourcen.

Als API-Anbieter sind Sie dafür verantwortlich, die APIs und API-Produkte für die Zugriffssteuerung, Nutzungsbeschränkungen und andere geschäftliche Anforderungen zu erstellen. Sie können zum Beispiel:

  • Ein kostenloses API-Produkt, das schreibgeschützten Zugriff auf seine API-Ressourcen ermöglicht, veröffentlichen.
  • Ein zweites API-Produkt zu einem niedrigen Preis, das Lese- / Schreibzugriff auf dieselben API-Ressourcen wie die kostenlose Version ermöglicht, jedoch mit einem niedrigen Zugriffslimit, z. B. 1.000 Anfragen pro Tag, veröffentlichen.
  • Ein drittes API-Produkt zu einem höheren Preis, das Lese- / Schreibzugriff auf dieselbe API-Ressource, jedoch mit einem hohen Zugriffslimit ermöglicht, veröffentlichen.

Wichtiger Hinweis: Apigee gibt Ihnen die Flexibilität, API-Produkte zu erstellen, die den geschäftlichen Anforderungen Ihrer APIs entsprechen.

Weitere Informationen zum Erstellen von API-Produkten finden Sie unter API-Produkte verwalten.

Aufgabe 2: Anwendungsentwickler registrieren

Ein Entwickler erstellt die Anwendungen, die Ihre APIs nutzen. Ein Anwendungsentwickler registriert sich bei Apigee, bevor er seine Anwendung registrieren kann. Wenn sie ihre Anwendung registrieren, erhalten sie einen API-Schlüssel, mit dem die Anwendung Zugriff auf die API erhält.

Mit der Anwendungsregistrierung können Sie steuern, wer Zugriff auf Ihre APIs hat. Sie können einen Anwendungsentwickler jederzeit löschen, wodurch alle mit diesem Entwickler verknüpften API-Schlüssel ungültig werden, sodass Sie dem Entwickler den Zugriff auf Ihre APIs verweigern.

Ein Diagramm mit der Schreibrichtung von links nach rechts, das einen Entwickler, eine Anwendung, APIs und Back-End-Dienste zeigt. Das Entwicklersymbol ist hervorgehoben. Eine gestrichelte Linie weist den Entwickler auf ein Symbol einer vom Entwickler erstellten Anwendung hin. Pfeile von und zurück zur Anwendung zeigen den Anfrage- und Antwortablauf auf ein API-Symbol, wobei der Anwendungsschlüssel über der Anfrage positioniert wird. Unter dem API-Symbol befinden sich zwei Gruppen von Ressourcenpfaden, die in zwei API-Produkte gruppiert sind: Standortprodukt und Medienprodukt.
    Das StandortProdukt enthält Ressourcen für /Länder, /Städte und /Sprachens und das Media-Produkt enthält Ressourcen für /Bücher, /Magazine und /Filme. Rechts neben der API befinden sich die Back-End-Ressourcen, die von der API aufgerufen werden, darunter eine Datenbank, ein Unternehmensdienstbus, Anwendungsserver und ein generisches Back-End.

Als API-Anbieter entscheiden Sie, wie Entwickler registriert werden. Sie können beispielsweise einen manuellen Registrierungsprozess verwenden, bei dem sich ein potenzieller Entwickler zur Registrierung an Ihre Organisation wenden muss. Der potenzielle Entwickler muss alle erforderlichen Informationen angeben, z. B. eine E-Mail-Adresse sowie einen Vor- und Nachnamen. Wenn Sie die Anfrage des Entwicklers genehmigen, können Sie die Apigee-Benutzeroberfläche verwenden, um den Entwickler manuell zu registrieren. Weitere Informationen finden Sie unter Anwendungsentwickler registrieren.

Aufgabe 3: Entwickleranwendung registrieren

Bevor eine Anwendung auf Ihre APIs zugreifen kann, muss sie registriert sein. Allerdings kann nur ein registrierter Entwickler eine Anwendung registrieren.

Ein Diagramm mit der Schreibrichtung von links nach rechts, das einen Entwickler, eine Anwendung, APIs und Back-End-Dienste zeigt. Die Pfeile für Anwendung, Anfrage/Antwort und API-Schlüssel sind hervorgehoben. Eine gestrichelte Linie weist den Entwickler auf ein Symbol einer vom Entwickler erstellten Anwendung hin. Pfeile von und zurück zur Anwendung zeigen den Anfrage- und Antwortablauf auf ein API-Symbol, wobei der Anwendungsschlüssel über der Anfrage positioniert wird. Das API-Symbol und die Ressourcen werden hervorgehoben. Unter dem API-Symbol befinden sich zwei Gruppen von Ressourcenpfaden, die in zwei API-Produkte gruppiert sind: Standortprodukt und Medienprodukt.
    Das StandortProdukt enthält Ressourcen für /Länder, /Städte und /Sprachens und das Media-Produkt enthält Ressourcen für /Bücher, /Magazine und /Filme. Rechts neben der API befinden sich die Back-End-Ressourcen, die von der API aufgerufen werden, darunter eine Datenbank, ein Unternehmensdienstbus, Anwendungsserver und ein generisches Back-End.

Bei der Anwendungsregistrierung wählt der Entwickler ein oder mehrere API-Produkte aus. Sie können beispielsweise mehrere API-Produkte veröffentlichen, die den jeweiligen Servicetypen und Preismodellen entsprechen. Der Anwendungsentwickler kann dann aus der Liste der verfügbaren API-Produkte eine Auswahl treffen.

Als Antwort auf die Registrierung der Anwendung in Apigee weist Apigee der Anwendung einen eindeutigen API-Schlüssel zu. Die Anwendung muss diesen API-Schlüssel als Teil jeder Anfrage an eine API-Ressource übergeben. Der Schlüssel wird authentifiziert und, sofern gültig, die Anfrage gewährt. Als Dienstanbieter können Sie den Schlüssel jederzeit widerrufen, damit die Anwendung nicht mehr auf Ihre APIs zugreifen kann.

Als API-Anbieter entscheiden Sie, wie Sie Anwendungen registrieren möchten. Sie haben folgende Möglichkeiten:

  • Verwenden Sie einen manuellen Prozess, der einen Entwickler benötigt, um Ihre Anwendung zu registrieren. Entsprechend würden Sie dem API-Schlüssel den Entwickler senden, möglicherweise per E-Mail.
  • Mit der Apigee API integrieren Sie die Funktion für die Anwendungsregistrierung und die Schlüsselübermittlung in Ihre Website.
  • Verwenden Sie für ein kostenpflichtiges Apigee-Konto das Apigee Developer Services-Portal, das Unterstützung für die Anwendungsregistrierung und die Bereitstellung von API-Schlüsseln unterstützt.

Weitere Informationen finden Sie unter Anwendungen registrieren und API-Schlüssel verwalten.

Aufgabe 4: APIs dokumentieren

Eine wichtige Überlegung bei der Veröffentlichung von API-Produkten ist die Bereitstellung von Dokumentation und Feedback-Verfahren für Entwickler. Entwicklerportale mit Funktionen für soziale Veröffentlichungen werden immer mehr für die Kommunikation mit der Entwicklungs-Community verwendet. Dies beinhaltet die Kommunikation von statischen Inhalten wie API-Dokumentation und Nutzungsbedingungen sowie dynamische Community-Inhalte wie Blogs und Foren sowie Kundensupportfunktionen.

Ein Diagramm mit der Schreibrichtung von links nach rechts, das einen Entwickler, eine Anwendung, APIs und Back-End-Dienste zeigt. Das Entwicklersymbol ist hervorgehoben. Unter dem Entwickler befindet sich ein Feld für ein Entwicklerportal. Das Portal enthält API-Dokumentation, Beispiele, Anleitungen, API-Referenz und mehr. Das Portal enthält auch Blogs, Foren und ein Supportportal.
    Eine gestrichelte Linie weist den Entwickler auf ein Symbol einer vom Entwickler erstellten Anwendung hin. Pfeile von und zurück zur Anwendung zeigen den Anfrage- und Antwortablauf auf ein API-Symbol, wobei der Anwendungsschlüssel über der Anfrage positioniert wird. Unter dem API-Symbol befinden sich zwei Gruppen von Ressourcenpfaden, die in zwei API-Produkte gruppiert sind: Standortprodukt und Medienprodukt.
    Das StandortProdukt enthält Ressourcen für /Länder, /Städte und /Sprachens und das Media-Produkt enthält Ressourcen für /Bücher, /Magazine und /Filme. Rechts neben der API befinden sich die Back-End-Ressourcen, die von der API aufgerufen werden, darunter eine Datenbank, ein Unternehmensdienstbus, Anwendungsserver und ein generisches Back-End.

Sie können Ihre eigene Website erstellen, um Ihre Dokumentation bereitzustellen, oder wenn Sie ein kostenpflichtiges Apigee-Konto haben, können Sie das Apigee Developer Services-Portal verwenden. Das Portal bietet integrierte Dokumentationen, Blogs, Foren und andere Inhalte, die zur Unterstützung Ihrer Entwickler-Community erforderlich sind.

Mit SmartDocs können Sie Ihre APIs im Entwickler Services-Portal so dokumentieren, dass die API-Dokumentation interaktiv ist. Durch die interaktive Dokumentation mit SmartDocs können Portalnutzer Folgendes tun:

  • Informationen zur API
  • Liveanfrage an die API senden
  • Von der API zurückgegebene Live-Antwort ansehen

Weitere Informationen finden Sie in den folgenden Abschnitten: