...
ChangeType | Corresponding internal events | Internal constant | |
|---|---|---|---|
AssetChanged | AssetCreated, AssetDeleted, AssetExternalProccessingFinished, AssetFolderUpdated, AssetLocationStateUpdated, AssetMetadataUpdated, AssetProfilePublished, AssetSecurityUpdated, AssetUploadFinished | ComboValueChanged | ComboValueCreated, ComboValueDeleted, ComboValueMetadataUpdated, ComboValueSecurityUpdated1 |
MetafieldChanged | MetafieldCreated, MetafieldDeleted, MetafieldMetadataUpdated, MetafieldSecurityUpdated | 2 | |
TreeValueChanged | TreeValueCreated, TreeValueDeleted, TreeValueMetadataUpdated, TreeValueSecurityUpdated | 4 | |
ComboValueChanged | ComboValueCreated, ComboValueDeleted, ComboValueMetadataUpdated, ComboValueSecurityUpdated | 8 |
An integration endpoint can subscribe to any subset of the four change types, but it must subscribe to at least one change type.
When subscribing to a change type, each time a corresponding internal event occurs, a notification will be sent to the URL registered for the integration endpoint. For instance, both AssetCreated and AssetDeleted events will trigger the same AssetChanged notification on all endpoints that subscribe to AssetChanged events. The events are debounced to avoid receiving too many identical change events over a short period of time. Thus, a small notification delay is to be expected.
Note that, it is possible to provide custom headers for the notification HTTP messages when registering an integration endpoint. This, however, is optional.
...
| Info |
|---|
More comprehensive Swagger documentation can be found at “<YOUR_DAM>/DigizuiteCore/IntegrationService/api-docs”, where <YOUR_DAM> is the base URL of the DC installation. E.g. “https://mm-dam.dev.digizuite.com”. |
Notifications
Notifications are, by definition, push-based. Thus, for an integration endpoint to receive notifications it should listen for incoming HTTP POST messages at the registered URL. A notification generally has the following JSON-formatted body:
| Code Block |
|---|
{
"ChangeType": <the change type of the event>,
"Data": {
<specificId>: <specificIdValue>,
"ItemId": <itemId of the item that triggered the event>
}
} |
The value of the “ChangeType” parameter is an integer, which is used to identify its change type. The mapping between ChangeTypes and their integer representations can be retrieved at “/IntegrationService/ChangeTypes”See the constants in the table above.For each of the change types, an additional data parameter is provided. The specific IDs are:
...