...
Dieser Bereich des Connection Designer dient der Verwaltung von Metadaten externer APIs. Diese können hier registriert (angelegt), bearbeitet oder deregistriert (gelöscht) werden. In den meisten Szenarien werden Sie auf API-Definitionen zurückgreifen, welche zusammen mit dem Connect Server ausgeliefert wurden. In diesem Fall ist keine Änderung an den registrierten APIs erforderlich.
Registrieren einer API (Connect 2022)
Voraussetzungen
Für die Registrierung einer neuen API, wird eine API-Beschreibung im OpenAPI- oder im Swagger-Format benötigt. Nähere Informationen zu OpenAPI finden Sie unter folgendem Link:
...
Die API-Beschreibung muss im JSON-Format vorliegen, Spezifikationen im YAML-Format können einfach mit Hilfe von Online-Kovertern Konvertern in das JSON-Format übersetzt werden. Die Benennung der JSON-Datei muss folgender Konvention folgen:
[Name des Herstellers]__[Name des Produkts]__[Version des Produkts bzw. der API].json
Leerzeichen innerhalb der einzelnen Namensbestandteile müssen durch einen Unterstrich (_) ersetzt werden, die Namensbestandteile werden durch einen doppelten Unterstrich (__) getrennt. Die entsprechende Datei muss den Punkt Administration → Speicherverwaltung im Verzeichnis “OpenAPI” abgelegt werden. Zur Spezifikation von Webhooks wird derzeit das Custom-Property “x-event” verwendet. Diese Vorgehendweise wird voraussichtlich im Rahmen der nächsten Connect Server Versionen angepasst.
...
Bei Passwörtern ist es wichtig, dass die Beschreibung im zugehörigen “title”-Attribut das Schlüsselwort “Password” enthält. Somit wird für die Eingabe ein verdecktes Passwortfeld generiert. Bei der Speicherung der Konfiguration kann dies gesamte Konfiguration oder auch Teile davon verschlüsselt werden, so dass z. B. Passwörter nicht im Klartext abgelegt werden. Nähere Informationen hierzu entnehmen Sie den Abschnitt Verbindungen - : Verwalten der Verbindungsinformationen.
...