OpenAPI-Spezifikation erstellen

Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info

In dieser Anleitung erstellen Sie eine OpenAPI-Spezifikation, um eine API zu modellieren, die einen Zielserver aufruft. Der Zielserver besteht aus einem sehr einfachen Node.js-basierten Server, den Sie auf Ihrem Computer erstellen und ausführen. Die Ausführung dieser Anleitung dauert etwa 10 Minuten.

Lerninhalte

In dieser Anleitung erfahren Sie, wie Sie:

Voraussetzungen

Dazu benötigen Sie Folgendes:

Einfachen Node.js-Server erstellen

So erstellen Sie einen einfachen Node.js-Server:

  1. Erstellen Sie eine Datei mit dem Namen index.js.

  2. Kopieren Sie den folgenden Node.js-Code in die Datei:

    var express = require('express');
var app = express();  

app.get('/v1/hello', function (req, res) {
  res.setHeader("Access-Control-Allow-Origin", "*");
  res.send('Hello World!\n');
});  

app.listen(3000, function () {
  console.log('Example app listening on port 3000!');
});

  3. Speichern Sie die Datei.

  4. Installieren Sie das erforderliche Express-Modul:

    npm install express

  5. Starten Sie den Server:

    node index.js

    Die folgende Nachricht wird zurückgegeben:
    Example app listening on port 3000

  6. Testen Sie die API, indem Sie die folgende HTTP-Anfrage senden. 

    curl localhost:3000/v1/hello

    Die API gibt Folgendes zurück: Hallo Welt!

OpenAPI-Spezifikation erstellen

Eine OpenAPI-Spezifikation erstellen, die die API modelliert, die den Node.js-Server aufruft.

  1. Melden Sie sich bei apigee.com/edge an.
  2. Wählen Sie in der seitlichen Navigationsleiste Entwickeln > Spezifikationen aus.
    Die Liste der Spezifikationen wird angezeigt.

  3. Klicken Sie auf + Spezifikation und wählen Sie im Drop-down-Menü Neue Spezifikation aus.

  4. Kopieren Sie den folgenden YAML-Inhalt: 

    swagger: "2.0"
info:
  version: "0.0.1"
  title: Hello World API
host: 127.0.0.1:3000
basePath: /v1
schemes:
  - http
consumes:
 - application/json
produces:
  - application/json
paths:
  '/hello':
    get:
      description: Returns greetings to the caller
      operationId: hello
      responses:
        "200":
          description: Success
          schema:
            $ref: "#/definitions/HelloWorldResponse"
        default:
          description: Error
          schema:
            $ref: "#/definitions/ErrorResponse"
definitions:
  HelloWorldResponse:
    required:
      - message
    properties:
      message:
        type: string
      age:
        type: number
  ErrorResponse:
    required:
      - message
    properties:
      message:
        type: string

  5. Fügen Sie den YAML-Inhalt in den linken Bereich des Editors ein. Dadurch wird der aktuelle Inhalt überschrieben.

  6. Klicken Sie auf Speichern.
    Sie werden aufgefordert, der Spezifikation einen Namen zu geben.

  7. Geben Sie einen Namen für die Spezifikation ein, z. B. simple-spec.

  8. Klicken Sie auf Weiter.
    Die Spezifikation wird gespeichert.

  9. Klicken Sie auf Schließen, um die Spezifikation zu schließen und zur Liste der Spezifikationen zurückzukehren.

Die neue Spezifikation wird in der Spezifikationsliste angezeigt.

Wie geht es weiter?

Glückwunsch! Sie haben Ihre erste OpenAPI-Spezifikation erstellt, um eine API zu modellieren, die einen Zielserver aufruft.

Weitere Informationen zum Erstellen eines API-Proxys aus einer OpenAPI-Spezifikation