Webhooks

About Webhooks

Our webhooks are a more efficient way of managing events than using the management API to query information that changes over time. Instead of constantly polling for updates, a webhook is set up once and is only triggered when a specific event occurs. The main advantage of webhooks is that they provide real-time data updates on the various parameters used in license management.

Webhooks are callback mechanisms that web applications use to provide real-time notifications to other systems. Essentially, a webhook is a way for an application to send data to another application automatically when certain events occur.

The basic idea behind webhooks is that one application sends an HTTP POST request to a URL specified by another application, indicating that a certain event has occurred. The receiving application then processes the data in the request and takes appropriate action based on the content.

Webhooks are commonly used in a wide variety of applications, such as:

  • Integrating with third-party services to receive notifications when specific events occur

  • Triggering custom workflows or automation tasks in response to user actions

  • Updating data in real-time across multiple systems and applications

  • Automating data synchronization between different systems

In essence, webhooks operate in contrast to APIs, which require the client application to continuously request updates from the server. With webhooks, the server proactively pushes data to the client, eliminating the need for the client to check for updates and reducing the server's workload constantly.

Security

Each webhook call is sent with the N-Signature header in the HTTP Post request. This header contains a signature of the webhooks payload message created with your account's RSA key. It's a good practice to create a signature from the payload received and compare it with the header value. If it matches, it means the webhook was sent by the Zentitle2 service and not by a malicious actor.

The RSA key can be obtained from the "API Credentials" page. An example of the signature verification is implemented in our example code: https://github.com/Nalpeiron/samples-dotnet/tree/master/Webhooks.Console

Managing webhooks

Adding a webhook

Webhooks are located under the "Account" > "Webhooks" on the left menu.


Editing a webhook


Deleting a webhook

Testing

This action generates a new WebhookEvent and triggers a call to the listener URI. The payload of this call is empty; the resource id contains the ID of the listener:

This event is not retried if the request fails. Hit 'Test' again to generate another event.

Using webhooks

Go to our API docs for more details on using the webhooks you have set up: https://api.zentitle.io/docs/#tag/Webhooks


Now go to the SDK and API documentation to learn about implementation.

Last updated

Zentitle2

Service terms

© Copyright - Nalpeiron, all rights reserved Website use subject to Terms and Conditions. See our Privacy Policy Use of Zentitle is subject to our Service Terms and Conditions