APIs Seite im Jitterbit API-Manager

Einführung

Die Seite APIs ist die Zielseite des API-Manager und bietet Harmony Organisationsadministratoren die Möglichkeit, benutzerdefinierte APIs zu verwalten, OData Dienste und Proxy-APIs über den API-Manager erstellt.

Mitglieder einer Rolle, der Lese Umfeld gewährt wurde können auch auf die Seite APIs für APIs in dieser Umfeld zugreifen. Mitglieder einer Rolle, der Schreibzugriff Umfeld gewährt wurde haben Schreibzugriff in dieser Umfeld.

Um auf die Seite APIs zuzugreifen, melden Sie sich beim Harmony Portal an, und gehen Sie dann über das Harmony-Portalmenü oben links zu API-Manager > APIs:

Stellen Sie sicher, dass Sie auf die gewünschte Organisation zugreifen. Diese kann in der oberen Navigationsleiste geändert werden (siehe Ändern der ausgewählten Organisation im Harmony-Portal).

Header der APIs Seite

Die Header oben auf der Seite APIs enthält diese Steuerelemente:

• Basis URL: Die Basis-API URL der Harmony Organisation.

• Verwendete Custom API URLs: Die Anzahl der aktuell verwendeten benutzerdefinierten API URLs im Verhältnis zur Gesamtzahl der benutzerdefinierten API URLs, die durch das Abonnement der Organisation zulässig sind. Aktuell verwendete API URLs bestehen aus den von veröffentlichten benutzerdefinierten und OData APIs und ihren veröffentlichten Klonen verwendeten URLs. Entwurfs APIs zählen nicht als verwendete API URLs.

• Verwendete Proxy-API URLs: Die Anzahl der aktuell verwendeten Proxy-API URLs im Verhältnis zur Gesamtzahl der Proxy API URLs, die durch das Abonnement der Organisation zugelassen sind. Aktuell verwendete Proxy-API URLs sind diejenigen, die von veröffentlichten Proxy-APIs und ihren veröffentlichten Klonen verwendet werden. Entwurfs-APIs zählen nicht als verwendete API URLs.

• Filter: Öffnet einen Bereich mit Steuerelementen zum Filtern der Tabelle nach API Typ, API Status, API -Gruppe, Umgebung, Sicherheitsprofil und den Daten Zuletzt bearbeitet und Zuletzt veröffentlicht:

  

  Filter werden sofort angewendet. Verwenden Sie die Schaltflächen Löschen oder Alle löschen, um Filter zurückzusetzen, und die Schließen-Schaltfläche zum Schließen des Fensters.

• Suchen: Geben Sie einen beliebigen Teil des API Namens, der Version, der Umfeld, des Typs, der Beschreibung, des Status oder des Datums bzw. der Uhrzeit der letzten Veröffentlichung oder Bearbeitung der API in das Suchfeld ein, um die Liste der APIs zu filtern (nur alphanumerische Zeichen). Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet.

• Ansicht: Klicken Sie auf das Fliese-Ansicht oder Listenansicht, um das Format umzuschalten, in dem APIs auf dieser Seite angezeigt werden. Die Kachelansicht ist die anfängliche Standardansicht. Wenn Sie die Seite APIs das nächste Mal laden, ist die zuletzt ausgewählte Ansicht bereits ausgewählt.

• API importieren: Öffnet den API Importbildschirm, wo Sie APIs im APK-Format importieren können (siehe APIs exportieren und importieren).

• API exportieren: Öffnet den API Exportbildschirm, wo Sie ausgewählte APIs im APK-Format exportieren können (siehe APIs exportieren und importieren).

• Neu: Verwenden Sie das Menü, um den zu erstellenden API -Typ auszuwählen, entweder Custom API oder Proxy-API:

  • Custom API: (Nur verfügbar, wenn eine benutzerdefinierte API URL verfügbar ist.) Öffnet den API Konfigurationsbildschirm, um eine neue benutzerdefinierte zu erstellen oder OData API.

  • Proxy-API: (Nur verfügbar, wenn eine Proxy-API URL verfügbar ist.) Öffnet den Proxy-API Konfigurationsbildschirm, um einen neuen Proxy zu erstellen API.

Kachelansicht

Um auf die Fliese zuzugreifen, wählen Sie das Symbol Kachel-Ansicht.

In der Kachelansicht werden APIs als Kacheln angezeigt. Jede Fliese hat eine Vorder- und eine Rückseite, die „umgedreht“ werden können, um zusätzliche API Informationen und Aktionen anzuzeigen. Standardmäßig wird die Vorderseite angezeigt. Die Rückseite wird angezeigt, wenn Sie mit der Maus über die Fliese fahren:

• Vorderseite: Die Vorderseite der Fliese zeigt den API Namen, die Version, die Umfeld, den API Typ (Benutzerdefiniert, OData oder Proxy), den API Status (Veröffentlicht, Veröffentlicht mit Entwurf oder Entwurf) und das Datum der letzten Bearbeitung oder Veröffentlichung (in MM/DD/YY Format) in lokaler Browserzeit. Die Farbe des Symbols links neben dem API -Status zeigt die Kategorie des API Status an:

  Symbol	Farbe	Kategorie
  	Grün	Die API ist veröffentlicht.
  	Gelb	Die API ist als Entwurf veröffentlicht.
  	Open Green	Die API ist ein Entwurf.

• Rückseite: Auf der Rückseite der Fliese (sichtbar, wenn Sie mit der Maus über eine Fliese fahren) werden der API Name, die Umfeld, die API -Beschreibung und der Name des Benutzers angezeigt, der die API zuletzt bearbeitet hat. Darüber hinaus sind diese Aktionen verfügbar:

  • Anzeigen/Bearbeiten: Öffnet den API Konfigurationsbildschirm (siehe Custom API Konfiguration, OData Dienstkonfiguration oder Proxy-API Konfiguration).

  • Aktionen: Klicken Sie auf das Aktionsmenü Symbol, um ein Menü mit diesen Aktionen zu öffnen:

    API Menüpunkt	Beschreibung
    	API Protokolle öffnet die API Protokolle-Seite, auf der Verarbeitungs- und debuggen (sofern die debuggen aktiviert ist) für alle APIs angezeigt werden.
    	Analytics öffnet die Analytics-Seite, auf der Verbrauchs- und Leistungsmesswerte für alle APIs angezeigt werden.
    	Klon öffnet den API -Konfigurationsbildschirm (siehe Custom API Konfiguration, OData Dienstkonfiguration oder Proxy-API Konfiguration), vorab ausgefüllt mit den Konfigurationsdetails der geklonten API und aktualisierten Standardwerten für diese Felder: API Name: Dem API Namen wird Kopie von vorangestellt. Dienststamm: Dem Dienststamm wird Kopie von vorangestellt. Version: Der Version wird -2 angehängt. Diese Zahl erhöht sich nicht mit zusätzlichen Klonen.
    	Export initiiert einen Download der API in eine Datei namens apis-export.apk. Diese Datei kann dann in eine andere Umfeld oder Organisation importiert werden (siehe APIs exportieren und importieren).
    	Löschen löscht die API dauerhaft. Wenn Sie auf Löschen klicken, wird ein Bestätigungsdialogfeld angezeigt, in dem Sie bestätigen können, dass Sie die API dauerhaft löschen möchten. Achtung OpenAPI-Dokumentation angezeigt auf dem Portal wird nicht automatisch aktualisiert, wenn Sie eine API löschen. Um die OpenAPI-Dokumentation zu aktualisieren, tun Sie dies über den Portal Manager Seite.

  • URL kopieren: Kopiert die API URL in Ihre Zwischenablage.

Listenansicht

Um auf die Listenansicht zuzugreifen, wählen Sie das Symbol Listenansicht.

In der Listenansicht werden APIs in einer Tabelle angezeigt. Jede Spalte wird unten beschrieben. Wenn Sie auf eine API Zeile klicken, wird die API Details-Schublade geöffnet (unten beschrieben).

Die verfügbaren Spalten lauten wie folgt:

• API Name: Der Name der API.

• Version Die Version der API, wie sie während der API -Konfiguration eingegeben wurde.

• Typ: Der Typ der API, einer von Custom API, OData-Dienst oder Proxy-API.

• Umgebung: Die Umfeld, in der die API gespeichert ist.

• Status: Der Status der API, einer von Veröffentlicht, Veröffentlicht als Entwurf oder Entwurf.

• Zuletzt bearbeitet: Das letzte gespeicherte Datum (in MM/DD/YYYY Format), Uhrzeit (im HH:MM:SS Format) und der Zeitraum (AM oder PM) in lokaler Browserzeit.

• Service-Stamm: Der öffentliche Name der API, wie er während der API -Konfiguration eingegeben wurde.

• Gruppe: Der Name aller API Gruppen, zu dem die API gehört.

• Bearbeitet von: Der Name des Benutzers, der die API zuletzt gespeichert hat.

• Zuletzt veröffentlicht: Das Veröffentlichungsdatum (in MM/DD/YYYY Format), Uhrzeit (im HH:MM:SS Format) und der Zeitraum (AM oder PM) in lokaler Browserzeit.

• Veröffentlicht von: Der Name des Benutzers, der die API zuletzt veröffentlicht hat.

• Gateway: Das API Gateway, das von der API verwendet wird.

• Dienste: Die Anzahl der für die API konfigurierten Dienste.

• Aktionen: Bewegen Sie den Mauszeiger über die API Zeile, um weitere Aktionen anzuzeigen:

  • Details: Öffnet die API Detailschublade (im nächsten Abschnitt beschrieben).

  • API Basis URL kopieren: Klicken Sie hier, um die Basis URL der API in Ihre Zwischenablage zu kopieren.

  • Exportieren: Öffnet die Ordnerauswahl für Ihren lokalen Computer. Wählen Sie einen Ordner aus, in dem der API Export gespeichert werden soll. Weitere Informationen finden Sie unter Exportieren und Importieren von APIs.

  • Bearbeiten: Öffnet die Seite Zusammenfassung und Bestätigung für die API, wo Sie die Einstellungen der API bearbeiten können.

  • Weitere Aktionen: Öffnet ein Menü mit diesen Aktionen:

    API Menüpunkt	Beschreibung
    Klon	Öffnet den API Konfigurationsbildschirm (siehe Custom API Konfiguration, OData Dienstkonfiguration oder Proxy-API Konfiguration), vorab ausgefüllt mit den Konfigurationsdetails der geklonten API und aktualisierten Standardwerten für diese Felder: API Name: Dem API Namen wird Kopie von vorangestellt. Dienststamm: Dem Dienststamm wird Kopie von vorangestellt. Version: Der Version wird -2 angehängt. Diese Zahl erhöht sich nicht mit zusätzlichen Klonen.
    Löschen	Löscht die API dauerhaft. Wenn Sie auf Löschen klicken, wird ein Bestätigungsdialogfeld angezeigt, in dem Sie bestätigen müssen, dass Sie die API dauerhaft löschen möchten. Achtung OpenAPI-Dokumentation angezeigt auf dem Portal wird nicht automatisch aktualisiert, wenn Sie eine API löschen. Um die OpenAPI-Dokumentation zu aktualisieren, tun Sie dies über den Portal Manager Seite.
    Auf Portal anzeigen	(Nur für benutzerdefinierte oder Proxy-APIs mit dem Status Veröffentlicht oder Veröffentlicht mit Entwurf aktiviert.) Öffnet das Portal Seite für die API.
    Protokolle anzeigen	Öffnet die API Protokolle-Seite, auf der Verarbeitungs- und debuggen (sofern die debuggen aktiviert ist) für alle APIs angezeigt werden.
    Analytics	Öffnet das Analytics-Seite, auf der Verbrauchs- und Leistungsmesswerte für alle APIs angezeigt werden.

API Detailschublade

Um die Details einer API anzuzeigen, wählen Sie in der Listenansicht eine API in der Tabelle aus. Unten im Fenster öffnet sich eine Schublade mit fünf Registerkarten: Profil, Einstellungen, Dienste, Sicherheitsprofile, Benutzerrollen (für benutzerdefinierte APIs und OData-Dienste) und Anforderungsheader (für Proxy APIs).

In der Header der Schublade werden die folgenden Details und Steuerelemente angezeigt:

• API Name und-Version: Zeigt den Namen der API und ihre Version (falls zutreffend) an.
• Zurück / Weiter: Navigiert durch die APIs Liste der Organisation.
• Erweitern: Erweitert die Schublade auf den Vollbildmodus. Klicken Sie nach dem Erweitern auf das Minimieren-Symbol, um zur vorherigen Ansicht zurückzukehren.
• Schließen: Schließt die Schublade.

Tab „Profil“

Auf der Tab Profil werden allgemeine Informationen zur API angezeigt:

• API Typ: Der Typ der API, einer von Custom API, OData-Dienst oder Proxy-API.

• Basis-API URL: Die Basis URL der API.

• Beschreibung: (Nur für benutzerdefinierte APIs und OData-Dienste sichtbar.) Die Beschreibung der API, wie sie während der API -Konfiguration eingegeben wurde.

• Vorhandene API URL: (Nur für Proxy APIs sichtbar.) Die URL der API zum Proxy.

Tab „Einstellungen“

Die Tab Einstellungen bietet einen Überblick über die (während der API Konfiguration angegebenen) API-Einstellungen:

Notiz

Um eine dieser Einstellungen zu bearbeiten, müssen Sie in der Tabelle in der Spalte Aktion der API auf Bearbeiten klicken.

• Timeout: Die Anzahl der Sekunden, bevor die API abläuft. Der Standardwert beträgt 30 Sekunden. Das Maximum beträgt 180 Sekunden.

  Notiz

  Diese Einstellung ist unabhängig von der Einstellung für das Operation Timeout in Integration Studio oder Design Studio. Einstellungen für das Timeout von Vorgängen werden nur dann verwendet, wenn ein privater Agent verwendet wird und die EnableAPITimeout Einstellung in der privaten Agent-Konfigurationsdatei ist aktiviert.

• Nur SSL: Wenn aktiviert (Standard), werden die Daten über SSL verschlüsselt und HTTPS für alle API -Anfragen und-Antworten erzwungen (empfohlen).

  Wenn deaktiviert, werden über API Anfragen und-Antworten übermittelte Daten nicht verschlüsselt und können von anderen abgefangen und eingesehen werden. Dadurch könnten möglicherweise vertrauliche Informationen offengelegt werden.

• CORS: Wenn aktiviert, wird das Cross-Origin Resource Sharing (CORS) Mechanismus wird verwendet (nicht empfohlen).

  Warnung

  CORS bewirkt, dass Operationen mit dem OPTIONS Methode zur Ausführung ohne Authentifizierung.

• Ausführliches Protokollieren aktivieren: Wenn aktiviert, umfasst das ausführliche Protokollieren für APIs Anforderungs- und Antwortdaten in jedem API Protokoll, um eingehende und ausgehende Daten zu überwachen und das Debuggen zu erleichtern. Diese Einstellung ist standardmäßig deaktiviert, da sie große Protokolldateien erstellen kann.

• Debug-Modus aktivieren bis: Zeigt das Datum und die Uhrzeit an, an denen der debuggen-Modus deaktiviert wird.

Tab „Dienste“

Die Tab Dienste enthält eine Tabelle mit einer Übersicht über die API Dienste:

Die Tabelle kann nach Dienstname, Methode, Pfad, Projekt, Auszulösender Vorgang oder Antworttyp sortiert werden, indem Sie auf die jeweilige Header klicken.

• Dienstname: Der Name des API Dienstes.

• Methode: Die Anforderungsmethode für den API Dienst, eine von GET, POST, PUT, DELETE, ALL oder (wenn die Methode auf CUSTOM gesetzt ist) der Name der benutzerdefinierten Methode.

• Pfad: Der Pfad für die Anfrage.

• Projekt: (Nur für benutzerdefinierte APIs und OData-Dienste sichtbar.) Der Name des Integration Studio Projekt.

• Auszulösende Operation: (Nur für benutzerdefinierte APIs und OData-Dienste sichtbar.) Der Name der aufgerufenen Operation.

• Antworttyp: (Nur für benutzerdefinierte APIs und OData-Dienste sichtbar.) Der Antworttyp, einer von Endziel, Systemvariable oder Keine Antwort.

• Aktionen: Bewegen Sie den Mauszeiger über die Servicezeile, um zusätzliche Aktionen anzuzeigen:

  • API Dienst-URL kopieren: Kopiert die API Dienst-URL in Ihre Zwischenablage.

  • Zum API Dienst gehen: Öffnet die Seite Zusammenfassung und Bestätigung für die API, wo Sie die Einstellungen der API bearbeiten können.

Tab „Sicherheitsprofile“

Die Tab Sicherheitsprofile enthält eine Liste aller Sicherheitsprofile wird verwendet, um den Zugriff für die Nutzung der API einzuschränken:

Die Tabelle kann nach Profilname, Typ oder Benutzername sortiert werden, indem Sie auf die entsprechende Header klicken.

• Profilname: Der Name des Sicherheitsprofils.

• Typ: Der Authentifizierungstyp, einer von Anonym, API Schlüssel, Basic oder OAuth 2.0.

• Benutzername: Zeigt den Benutzernamen für alle Sicherheitsprofile an, die die Basisauthentifizierung verwenden. Andernfalls wird der Authentifizierungstyp angezeigt.

• Aktionen: Bewegen Sie den Mauszeiger über die Zeile des Sicherheitsprofils, um eine zusätzliche Aktion anzuzeigen:

  • Zum Sicherheitsprofil gehen: Öffnet den Konfigurationsbildschirm für das Sicherheitsprofil.

Tab „Benutzerrollen“

Die Tab Benutzerrollen bietet eine Liste der Organisationsrollen, deren Mitglieder Zugriff auf die API haben:

Notiz

Diese Tab ist nur für benutzerdefinierte APIs und OData-Dienste sichtbar.

Durch Klicken auf die entsprechende Header kann die Tabelle nach Benutzerrolle sortiert werden.

• Benutzerrolle: Der Name der Harmony Rolle.

• Aktionen: Bewegen Sie den Mauszeiger über die Zeile mit der Rolle, um eine zusätzliche Aktion anzuzeigen:

  • Gehe zu Rolle: Öffnet die Benutzerverwaltung der Management Console Seite.

Tab „Anforderungsheader“

Die Tab Anforderungsheader enthält eine Liste der Anforderungsheader der Proxy-API:

Notiz

Diese Tab ist nur für Proxy-APIs sichtbar.

Durch Klicken auf die jeweilige Header kann die Tabelle nach Schlüssel oder Wert sortiert werden.

• Schlüssel: Der Schlüssel des Anforderungsheaders.

• Wert: Der Wert des Anforderungsheaders.

• Eingehende überschreiben: Wenn aktiviert, überschreibt der Header andere Anforderungsheader, die denselben Schlüssel verwenden.

  Hinweis

  Um diese Einstellung zu bearbeiten, müssen Sie in der Tabelle in der Spalte Aktion der API auf Bearbeiten klicken.

Einstellungen für die Listenansichtsseite

Sie können die Tabelle sortieren, ihre Spalten neu anordnen oder ihren Inhalt aktualisieren:

• Sortieren: Um die Tabelle in aufsteigender Reihenfolge zu sortieren, klicken Sie auf eine beliebige Spaltenüberschrift. Klicken Sie erneut, um die Sortierreihenfolge umzukehren.

• Spalten: Um die Anordnung und Sichtbarkeit von Spalten zu ändern, klicken Sie auf Spalten filtern. Die Schublade Spalten wird geöffnet:

  

  Die Schublade verfügt über die folgenden Steuerelemente:

  • Suchen: Geben Sie einen beliebigen Teil des Spaltennamens in das Suchfeld ein, um die Spaltenliste zu filtern (nur alphanumerische Zeichen). Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden.

  • Alle anzeigen: Alle Spalten sichtbar machen.

  • Verschieben: Durch Ziehen und Ablegen können Sie die Position der Spalte im Verhältnis zu anderen ändern.

  • Ausblenden: Die Spalte ist sichtbar. Klicken Sie, um sie auszublenden.

  • Anzeigen: Die Spalte ist ausgeblendet. Klicken Sie, um sie anzuzeigen.

  • Speichern: Die Spalten speichern.

  • Abbrechen: Die Spaltenschublade schließen, ohne die Änderungen zu speichern.