Tutorial: Importieren und Veröffentlichen Ihrer ersten API

In diesem Tutorial wird veranschaulicht, wie Sie eine Back-End-API mit OpenAPI-Spezifikation im JSON-Format in Azure API Management importieren. Microsoft stellt die in diesem Beispiel verwendete Back-End-API bereit und hostet sie in Azure unter https://conferenceapi.azurewebsites.net.

Nachdem Sie die Back-End-API in API Management importiert haben, wird Ihre API Management-API zu einer Fassade für die Back-End-API. Sie können die Fassade an Ihre Anforderungen in API Management anpassen, ohne hierfür die Back-End-API bearbeiten zu müssen. Weitere Informationen finden Sie unter Transformieren und Schützen Ihrer API.

In diesem Tutorial lernen Sie Folgendes:

  • Importieren einer API in API Management
  • Testen der API im Azure-Portal

Nach dem Import können Sie die API im Azure-Portal verwalten.

Screenshot of a new API in API Management in the portal.

Voraussetzungen

Navigieren zur API Management-Instanz

  1. Suchen Sie im Azure-Portal nach API Management-Dienste, und wählen Sie diese Option aus.

    Select API Management services

  2. Wählen Sie auf der Seite API Management-Dienste Ihre API Management-Instanz aus.

    Select your API Management instance

Importieren und Veröffentlichen einer Back-End-API

In diesem Abschnitt wird gezeigt, wie Sie eine Back-End-API mit OpenAPI-Spezifikation importieren und veröffentlichen.

  1. Wählen Sie im linken Navigationsbereich der API Management-Instanz APIs aus.

  2. Wählen Sie die Kachel OpenAPI aus.

  3. Wählen Sie im Fenster Aus OpenAPI-Spezifikation erstellen die Option Vollständig aus.

  4. Geben Sie die Werte aus der folgenden Tabelle ein.

    Sie können API-Werte während der Erstellung oder später über die Registerkarte Einstellungen festlegen.

    Screenshot of creating an API in the portal.

    Einstellung Wert BESCHREIBUNG
    OpenAPI-Spezifikation https://conferenceapi.azurewebsites.net?format=json Gibt den Back-End-Dienst an, der die API und die von der API unterstützten Vorgänge implementiert.

    Die Back-End-Dienst-URL wird später als Webdienst-URL auf der Seite Einstellungen der API angezeigt.

    Nach dem Import können Sie Vorgänge in der Spezifikation hinzufügen, bearbeiten, umbenennen oder löschen.
    Einschließen von Abfrageparametern in Vorgangsvorlagen Aktiviert (Standardeinstellung) Gibt an, ob erforderliche Abfrageparameter in der Spezifikation als Vorlagenparameter in API Management importiert werden sollen.
    Anzeigename Nachdem Sie die URL der OpenAPI-Spezifikation eingegeben haben, füllt API Management dieses Feld basierend auf JSON aus. Der Name im Entwicklerportal angezeigte Name.
    Name Nachdem Sie die URL der OpenAPI-Spezifikation eingegeben haben, füllt API Management dieses Feld basierend auf JSON aus. Ein eindeutiger Name für die API.
    Beschreibung Nachdem Sie die URL der OpenAPI-Spezifikation eingegeben haben, füllt API Management dieses Feld basierend auf JSON aus. Eine optionale Beschreibung der API.
    URL-Schema HTTPS Gibt an, welche Protokolle auf die API zugreifen können.
    API-URL-Suffix conference Das Suffix wird an die Basis-URL für den API Management-Dienst angehängt. API Management unterscheidet APIs anhand des Suffix. Daher muss jede API eines bestimmten Herausgebers ein eindeutiges Suffix haben.
    Tags Tags zum Organisieren von APIs für die Suche, Gruppierung oder Filterung.
    Produkte Unbegrenzt Zuordnung von einer oder mehreren APIs. Jede API Management-Instanz enthält zwei Beispielprodukte: Starter und Unbegrenzt. Zur Veröffentlichung einer API muss diese einem Produkt zugeordnet werden (in diesem Beispiel Unbegrenzt).

    Sie können mehrere APIs in ein Produkt aufnehmen und Entwicklern über das Entwicklerportal Produktabonnements anbieten. Geben Sie den Produktnamen ein, oder wählen Sie ihn aus, um diese API einem anderen Produkt hinzuzufügen. Wiederholen Sie diesen Schritt, um die API mehreren Produkten hinzuzufügen. Sie können APIs Produkten auch später über die Seite Einstellungen hinzufügen.

    Weitere Informationen zu Produkten finden Sie unter Erstellen und Veröffentlichen eines Produkts.
    Gateways Verwaltet API-Gateways, die die API verfügbar machen. Dieses Feld ist nur bei Diensten mit Developer- und Premium-Tarif verfügbar.

    Verwaltet gibt an, dass das Gateway in den API Management-Dienst integriert ist und von Microsoft in Azure gehostet wird. Selbstgehostete Gateways sind nur bei Diensten mit Premium- und Developer-Tarif verfügbar. Sie können sie lokal oder in anderen Clouds bereitstellen.

    Wenn keine Gateways ausgewählt sind, ist die API nicht verfügbar, und Ihre API-Anforderungen können nicht erfolgreich ausgeführt werden.
    Versionsverwaltung für diese API? Auswählen bzw. Aufheben der Auswahl Weitere Informationen finden Sie unter Veröffentlichen mehrerer Versionen Ihrer API.

    Hinweis

    Wenn Sie die API für API-Consumer veröffentlichen möchten, müssen Sie sie einem Produkt zuordnen.

  5. Wählen Sie Erstellen aus, um Ihre API zu erstellen.

Falls beim Importieren einer API-Definition Probleme auftreten, helfen Ihnen die Informationen in der Liste mit den bekannten Problemen und Einschränkungen weiter.

Testen der neuen API im Azure-Portal

Sie können API-Vorgänge direkt über das Azure-Portal aufrufen. Dies ist ein einfacher Weg, die Vorgänge anzuzeigen und zu testen. In der Testkonsole des Portals werden APIs standardmäßig mithilfe eines Schlüssels aus dem integrierten Abonnement mit Universalzugriff aufgerufen. Sie können API-Aufrufe auch testen, indem Sie einen Abonnementschlüssel verwenden, der nur für ein Produkt gültig ist.

  1. Wählen Sie im linken Navigationsbereich der API Management-Instanz APIs>Demo Conference API aus.

  2. Wählen Sie die Registerkarte Test und dann GetSpeakers aus. Auf der Seite werden Abfrageparameter und Header angezeigt (falls zutreffend).

    Im Abschnitt HTTP-Anforderung wird der Header Ocp-Apim-Subscription-Key automatisch für Sie ausgefüllt, was Sie sehen können, wenn Sie das „Auge“-Symbol auswählen.

  3. Wählen Sie Send (Senden) aus.

    Screenshot of testing an API in Azure portal.

    Das Back-End antwortet mit 200 OK und einigen Daten.

Nächste Schritte

In diesem Tutorial haben Sie Folgendes gelernt:

  • Importieren Ihrer ersten API
  • Testen der API im Azure-Portal

Im nächsten Tutorial erfahren Sie, wie Sie ein Produkt erstellen und veröffentlichen: