Using the Event Notification Service REST API

A software producer’s ecosystem usually involves upstream and downstream systems, with FlexNet Operations being placed between those systems. It is vital that consistent information is shared between all of these systems. Event notifications help producers keep all related enterprise systems up to date. You can use the Event Notification Service API to trigger an event notification whenever a specific event related to products, entitlements or devices occurs. Real-time data about the event is delivered to a specified webhook URL where the data can be consumed programmatically to update the producer’s upstream or downstream systems.

Once a webhook has been created, anything can make use of this data. For example, you could use the data to feed an auditing system to keep track of changes made, when and by whom.

The Event Notification Service captures changes related to products, entitlements, or devices in the FlexNet Operations Transactional Database. The following diagram shows the data flow from the Transactional Database:

Data flow for event notifications

Producers subscribe to and configure event notifications via the Event Notification Service REST API.

To receive event notifications, the producer must provide the webhook endpoint URLs. These URLs are the endpoints to which the event notifications payload (in JSON format) will be delivered.

The webhooks for entitlement and product and device events may be different. However, these webhooks must be accessed using the same credentials (that is, using the same user name and password for basic authentication).

This section details which events trigger an event notification and explains how to configure event notifications. It is grouped into the following subsections:

• Events Triggering Event Notifications
• Accessing the Event Notification Service REST API
• Configuring Event Notifications
• Payload to Webhook Endpoints
• Monitoring the Event Notification Service Status

Additional Documentation

In addition to this manual, you can consult the Swagger documentation, which provides more detailed information.

Depending on your AWS instance, use one of the following URLs to access the Event Notification Service REST API documentation on Swagger:

https://<siteID>-uat.flexnetoperations.eu/notifications/swagger-ui.html

https://<siteID>-uat.flexnetoperations.com/notifications/swagger-ui.html

where <siteID> is your organization’s site ID which is supplied by Revenera. For production environments, omit "‑uat". For more information on <siteID>, see About Your Site ID.