OpenAPI-Unterstützung im REST-Schritt

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

    • Füllen Sie REST-Schrittfelder und Aktionseingaben mit aus einer OpenAPI-Spezifikation importierten Informationen aus. Importieren Sie Spezifikationen, indem Sie eine URL für YAML oder JSON bereitstellen oder Inhalte kopieren und einfügen.

    Vorteile

    OpenAPI-Support im REST-Schritt bietet diese Vorteile.

    • Verwenden Sie Informationen, die aus einer OpenAPI-Spezifikation importiert wurden, um REST-Schrittvorgänge, HTTP-Methoden, Parameter, Anforderungstext, Pfad und Header zu konfigurieren.
    • Überprüfen Sie verfügbare API-Vorgänge, ohne die Flow Designer-Schnittstelle zu verlassen.
    • Generieren Sie Eingaben, die für den REST-Schritt erforderlich sind, um gültige Anforderungen an einen OpenAPI-Service zu senden, und fügen Sie sie dem REST-Schritt an der richtigen Position hinzu.
    Hinweis:
    Überprüfen Sie immer die aus einer OpenAPI-Spezifikation importierten REST-Schrittwerte, bevor Sie eine Anforderung senden. Entfernen Sie Parameter, Header und Eingaben, die die API nicht benötigt.

    Generierte Eingaben

    Wenn Sie eine OpenAPI-Spezifikation importieren, erstellt das System alle erforderlichen Eingaben und fügt sie gegebenenfalls dem REST-Schrittformular hinzu. Zur Laufzeit sendet das System eine REST-Anforderung, die Eingabewerte enthält, die für die Aktion bereitgestellt werden. Wenn eine API beispielsweise einen in der Anforderung übergebenen Namensparameter erfordert, erstellt das System eine Namenseingabe und fügt sie dem REST-Schritt hinzu. Wenn Sie die Aktion dem Flow hinzufügen, wird der Name zu einer Eingabe in die Aktion.

    Das System ordnet OpenAPI-Datentypen den Datentypen Flow Designer zu. Wenn die OpenAPI-Spezifikation beispielsweise ein Benutzerobjekt erfordert, erstellt das System ein komplexes Datenobjekt als Eingabe. Weitere Informationen finden Sie unter Komplexe Daten.

    Größenbeschränkung für Spezifikationen

    Standardmäßig kann das System OpenAPI-Spezifikationen mit bis zu 10 MB importieren. Um die Importgröße zu erhöhen, aktualisieren Sie die Systemeigenschaft glide.rest.openapi.max_request_size. Der maximale Wert beträgt 100 MB.

    Spezifikationsverwaltung

    Importieren Sie eine OpenAPI-Spezifikation, indem Sie im REST-Schritt Optionen auswählen. Weitere Informationen finden Sie unter REST-Schritt. Durch das Importieren einer OpenAPI-Spezifikation wird ein Datensatz in der OpenAPIs-Tabelle [sys_openapi] erstellt. Sie können Spezifikationsdatensätze direkt in dieser Tabelle anzeigen oder löschen. Um eine Spezifikation zu aktualisieren, löschen Sie sie und importieren Sie sie erneut.

    Design Überlegungen

    Erstellen Sie unter Berücksichtigung dieser Überlegungen einen REST-Schritt aus einer OpenAPI-Spezifikation.

    Entfernen Sie unnötige REST-Schrittparameter
    Beim Importieren einer OpenAPI-Spezifikation fügt das System dem REST-Schritt alle in der Spezifikation enthaltenen Parameter und Header hinzu. Überprüfen Sie die endgültigen REST-Schrittwerte, und entfernen Sie Parameter, die Sie in der Anforderung nicht senden möchten. Wenn die API beispielsweise Inhaltstypheader für JSON und XML akzeptiert, fügt das System beide Header dem REST-Schritt hinzu. Entfernen Sie je nach Inhaltstyp, den Sie in der Antwort erhalten möchten, einen der Header.
    Gestalten Sie Eingabebezeichnungen benutzerfreundlich
    Stellen Sie sicher, dass die für den REST-Schritt erforderlichen Eingabebezeichnungen klar und verständlich sind. Eindeutige Bezeichnungen ermöglichen es Flow-Designern, die erforderlichen Eingaben bei Verwendung der Aktion in einem Flow leicht zu verstehen.
    Entfernen Sie Eingaben, die keine Flow Designer-Konfiguration erfordern
    Beim Importieren einer OpenAPI-Spezifikation fügt das System dem Aktionseingabeabschnitt alle in der Spezifikation enthaltenen Eingaben hinzu. Entfernen Sie alle Eingaben, für deren Konfiguration kein Flow Designer erforderlich ist. Wenn beispielsweise eine REST-Schrittvariable einen Wert von einem anderen Schritt in der Aktion erhält, ist keine Aktionseingabe erforderlich.
    Vermeiden Sie es, den API-Vorgang zu ändern
    Wenn Sie den Wert des Felds API-Vorgang ändern, werden alle von diesem Vorgang abhängigen Werte entfernt. Wenn Sie die OpenAPI-Spezifikationswerte im REST-Schrittformular konfigurieren und dann den Vorgang ändern, speichert das System Ihre Konfiguration nicht. Werte, die manuell von einem Benutzer eingegeben werden, sind nicht betroffen.

    Einschränkungen

    Erstellen Sie einen REST-Schritt aus einer OpenAPI-Spezifikation mit diesen Einschränkungen.

    Medientypen des Anforderungstexts
    Der Anforderungstext unterstützt nur JSON- und XML-basierte Medientypen. Wenn der ausgewählte Vorgang aus der importierten OpenAPI-Spezifikation einen Anforderungstext mit einem anderen Medientyp enthält, fügt das System dem Feld Anforderungstext eine Datenpille vom Typ Zeichenfolge hinzu.
    OpenAPI 3.0-Komponenten

    OpenAPI 3.0 fügt neue Komponenten zu SWAGGER 2.0 hinzu, um eine API detaillierter zu beschreiben. OpenAPI-Support im REST-Schritt unterstützt einige, aber nicht alle dieser Komponenten. Der REST-Schritt unterstützt diese Komponenten derzeit nicht.

    • Schemaobjekt: oneOf-, anyOf-Eigenschaften
    • Diskriminatorobjekt
    • Info-Objekt: „termsOfService“, „Kontakt“, „Lizenz“-Felder
    • Beispielobjekt
    • Link-Objekt
    • Rückrufobjekt
    • Sicherheitsschemaobjekt
    • Sicherheitsanforderungsobjekt
    • Tag-Objekt
    • Externes Dokumentationsobjekt
    • Serverobjekt
    • Spezifikationserweiterungen
    • Rekursive Referenzen

    Weitere Informationen zu diesen Komponenten finden Sie in der OpenAPI-Dokumentation. Weitere Informationen finden Sie unter OpenAPI-Spezifikation.