Gezielte Synchronisation von bestimmten Datensätzen

Soll ein bestimmter Datensatz per HubEngine Trigger übertragen werden, so kann dies über die HubEngine Trigger erfolgen. Sowohl die Action-URL als auch die Trigger-URL bieten die Möglichkeit, beim Aufruf einzelne Datensatz-IDs zu senden.

Im Folgenden wird erklärt, wie du diese Funktion jeweils nutzen kannst.
Die beiden Möglichkeiten unterscheiden sich in der Anzahl der Datensätze, die übertragen werden können.

Mit der Trigger-URL können mehrere Datensätze durch eine Anfrage zur Übertragung ausgelöst werden, mit der Action-URL nur ein Datensatz pro Richtung.

In der Erläuterung werden die Begriffe „primär“ und „sekundär“ verwendet. Da ein HubEngine Plan immer aus zwei verbundenen Systemen besteht, muss unterschieden werden, aus welchem System ein Datensatz übertragen werden soll. (Quelle der Änderung)

Als „primary“ System wird immer das linke System in einer Planansicht bezeichnet und als „secondary“ immer das rechte System.

Wenn Du also einen Plan zwischen Hubspot und Microsoft Dynamics hast, dann ist das „primary“ System Hubspot und das „secondary“ System Microsoft Dynamics. Dies ist dann die Referenz beim Aufruf der Trigger-URL sowie der Action-URL.

Left: Primary System HubSpot, Right: Secondary System Microsoft Dynamics

Trigger-URL

Da der Trigger-URL Endpunkt ausschließlich per POST/PUT Request angesprochen werden kann, müssen ID’s per JSON-Body übergeben werden. Dieser sollte z.B. so aussehen: 

POST https://integration.hubengine.eu/hook/trigger/abcd1234 
{ 

"primary": ["idA", "idB", "idC"], 

"secondary": ["id1", "id2", "id3"] 

} 

Dabei kann der Key „primary“ sowie „secondary“ benutzt werden, jeweils mit einer Liste von IDs die mit dem Aufruf übertragen werden sollen. Dabei ist die Übergabe optional, also müssen nicht angegeben werden. 

In jede Richtung können dabei jeweils bis zu 5.000 IDs übergeben werden, also maximal mit einem Request 10.000 Datensätze für den Übertrag gemeldet werden. 

Werden so IDs übergeben, wird die HubEngine den Abruf von geänderten Datensätzen für diesen Plan Durchlauf überspringen. 

Action-URL

Da die Action-URL ausschließlich per GET Request angesprochen werden kann, kann damit die Übertragung eines einzelnen Datensatzes angestoßen werden. 

GET https://integration.hubengine.eu/hook/trigger/abcd1234?primary=idA 

Dabei kann sowohl der Parameter „primary“ und/oder „secondary“ benutzt werden, um genau einen Datensatz durch die HubEngine übertragen zu lassen. 

Auch bei diesem Aufruf wird der Abruf von geänderten Datensätzen für diesen Plan Durchlauf übersprungen. 

Limitierung des Aufrufs

Beide Endpunkte können maximal 6 mal in einer Minute aufgerufen werden. Wird dieses Limit überschritten, Antwortet die HubEngine mit einem 429 Too Many Requests Status Code.