Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

✕

API -Typen im Jitterbit API-Manager

Übersicht

Innerhalb des API-Manager können Sie drei Arten von APIs erstellen und veröffentlichen:

Jeder API Typ interagiert innerhalb der Systemarchitektur auf einzigartige Weise mit Harmony, wie unten beschrieben.

Weitere Informationen zur Jitterbit-Sicherheit und-Systemarchitektur finden Sie im Whitepaper zur Jitterbit-Sicherheit und-Architektur.

Custom API

Benutzerdefinierte APIs stellen eine Harmony Operation zur Nutzung bereit. Eine Operation muss zunächst erstellt und in Harmony bereitgestellt werden und kann eine beliebige Integration Studio oder Design Studio Operation. Die vorhandene Operation wird dann während der Konfiguration der benutzerdefinierten API referenziert und von einem API Consumer aufgerufen und genutzt. Benutzerdefinierte APIs werden über Jitterbit-Agenten (entweder Cloud-Agent-Gruppen oder private Agenten).

Dieses Diagramm zeigt, wie sich eine benutzerdefinierte API in der Systemarchitektur verhält, wenn sie mit einem Cloud-Agenten und einem Cloud API Gateway bereitgestellt wird:

Diagramm Customsom API Cloud-Bereitstellung pp

  1. Ein API Verbraucher ruft die benutzerdefinierte API am Cloud API Gateway auf.

  2. Die benutzerdefinierte API Anforderung wird über das Cloud-API Gateway an den Messaging-Dienst weitergeleitet, der Anforderungen für Agentengruppen weiterleitet.

  3. Ein Cloud-Agent empfängt die Anfrage vom Messaging-Dienst.

  4. Der Cloud-Agent verweist auf die benutzerdefinierte API Operation, die während der benutzerdefinierten API Konfiguration angegeben wurde und löst die bereitgestellte Operation aus.

  5. Die Operation antwortet mit einer API Payload, die mit dem Antworttyp übereinstimmt, die während der benutzerdefinierten API Konfiguration ausgewählt wurde.

  6. Die API Payload wird vom Cloud-Agenten zurück zum API Verbraucher geleitet.

    Notiz

    Sofern der durch den API Aufruf ausgelöste Operation nicht Temporärer Speicher verwendet, verbleibt die API Payload nur zwei Tage lang auf dem Agenten.

  7. Laufzeitstatusinformationen und Protokolle laufender Vorgänge werden an die Datenbank mit Transaktionsprotokollen gesendet.

    Notiz

    Verbraucherdaten werden nicht in der Datenbank der Transaktionsprotokolle gespeichert, es sei denn, debuggen Modus ist während der benutzerdefinierten API Konfiguration aktiviert.

Informationen zum Konfigurieren einer benutzerdefinierten API finden Sie unter Custom API -Konfiguration.

OData-Dienst

OData-Dienste stellen ein Design Studio API Operation bereit zur Nutzung. Die API Operation muss zunächst erstellt und in Harmony bereitgestellt werden. Die vorhandene API Operation wird dann während der Konfiguration des OData Dienstes referenziert und von einem API Consumer aufgerufen und genutzt. OData Dienste werden über Jitterbit-Agenten (entweder Cloud-Agent-Gruppen) weitergeleitet oder private Agenten).

Dieses Diagramm zeigt, wie sich ein OData Dienst in der Systemarchitektur verhält, wenn er vor Ort mit einem privaten Agenten und einem privaten API Gateway bereitgestellt wird:

Diagramm OData Dienst vor Ort Bereitstellung pp

  1. Ein API Verbraucher ruft den OData-Dienst am privaten API Gateway auf..

  2. Die OData Serviceanforderung wird über das private API Gateway weitergeleitet.

  3. Die Anfrage wird vom Messaging-Dienst empfangen, der Anfragen für Agentengruppen weiterleitet.

  4. Der private Agent empfängt die Anfrage vom Nachrichtendienst.

  5. Der private Agent verweist auf die Operation der OData-Service API in Harmony und löst die bereitgestellte Operation aus.

  6. Der Operation antwortet mit einer API Payload, die vom privaten Agenten über das private API Gateway zurück zum API Verbraucher geleitet wird.

    Notiz

    Sofern der durch den API Aufruf ausgelöste Operation nicht Temporärer Speicher verwendet, verbleibt die API Payload nur zwei Tage lang auf dem Agenten.

  7. Laufzeitstatusinformationen und Protokolle laufender Vorgänge werden an die Transaktionsprotokolldatenbank auf dem privaten Agenten gesendet.

    Notiz

    Verbraucherdaten werden nicht in der Datenbank der Transaktionsprotokolle gespeichert, es sei denn, debuggen Modus ist während der OData-Dienstkonfiguration aktiviert.

  8. Protokolle des privaten Agenten können optional mit der Transaktionsprotokolldatenbank innerhalb von Harmony synchronisiert werden.

Informationen zum Konfigurieren eines OData Dienstes finden Sie unter OData-Dienstkonfiguration.

Proxy-API

Im Gegensatz zu benutzerdefinierten APIs oder OData-Dienste, die einen Harmony Operation zur Nutzung bereitstellen, werden Proxy APIs mit einer vorhandenen Drittpartei API verwendet und nicht über Jitterbit-Agenten weitergeleitet. Die proxiede API muss für das Gateway, das die API verarbeitet, zugänglich sein, entweder das Cloud API Gateway oder ein privates API Gateway:

  • Cloud API -Gateway: Wenn Sie das API Gateway verwenden, das Jitterbit auf Harmony hostet, muss die vorhandene API öffentlich zugänglich sein, auch wenn sie gesichert ist. Das heißt, die API, die Sie proxyen möchten, darf sich nicht hinter einer Firewall befinden. Informationen zum Zulassungsliste der IP-Adressen des Cloud API -Gateways, um dem Gateway Zugriff auf die geproxte API zu gewähren, finden Sie unter Informationen zur Whitelist und navigieren Sie zu https://services.jitterbit für Ihre Region.

  • Privates API -Gateway: Bei Verwendung eines privaten API Gateways, muss die vorhandene API über das private API Gateway zugänglich sein.

Dieses Diagramm zeigt, wie sich eine Proxy-API in der Systemarchitektur verhält, wenn sie vom Cloud API -Gateway verarbeitet wird:

Diagramm Proxy-API Cloud-Bereitstellung pp

  1. Ein API Verbraucher ruft die Proxy-API am Cloud API Gateway auf.

  2. Der Proxy API Aufruf wird über das Cloud-API Gateway geleitet und an die als Proxy verwendete Drittpartei API gesendet.

  3. Die API Payload wird über das Cloud-API Gateway zurück an den API Verbraucher geleitet.

  4. Die Drittpartei API antwortet mit einer API Payload, die über das Cloud-API Gateway zurück zum API Verbraucher geleitet wird.

  5. Laufzeitstatusinformationen werden an die Datenbank der Transaktionsprotokolle gesendet.

    Notiz

    Verbraucherdaten werden nicht in der Datenbank der Transaktionsprotokolle gespeichert, es sei denn, debuggen Modus ist während der Proxy-API Konfiguration aktiviert.

Informationen zum Konfigurieren einer Proxy-API finden Sie unter Proxy-API -Konfiguration.