The Objects API can be configured to send notifications to a configured Notificaties API. These notifications are sent whenever Objects are created, updated or deleted via the Objects API. Other applications can subscribe to these notifications, for example to trigger certain processes whenever an Object is created.
For more information on the Notificaties API, please refer to the documentation.
In order to configure notifications, navigate to the admin page and click on the "change" button next to "Notificatiescomponentconfiguratie", under the "Configuration" tab.
On the next page, fill in the correct API root of the Notificaties API to which notifications must be sent and click on the "save" button afterwards.
Navigate back to the admin index page and click on the "add" button next to "Services", under the "Configuration" tab.
On the "add service" page, fill in the following information:
- Label: the name of the Service, i.e.
Notificaties API
- Type:
NRC (Notifications
- Api root url: the same URL as in the "Notificatiescomponentconfiguratie"
- Client ID: a valid client ID to identify the Objects API (registered in Autorisaties API)
- Secret: a secret corresponding to the client ID (registered in Autorisaties API)
- Authorization type:
ZGW client_id + secret
- Header key / Header value: leave empty
- OAS: a URL pointing to the OpenAPI specification of the Notificaties API, the API root from step 2, followed by
schema/openapi.yaml
- Nlx url: leave empty
- User ID: a user ID to show in the audittrail
- User representation: a human readable representation of this application to show in the audittrail
Finally, click on the "save" button.
In order for this configuration to work, API authorizations must be configured in an Autorisaties API. Open Zaak is an example of an application that implements this API. For more information on how to configure API authorizations in Open Zaak, please refer to the Open Zaak authorization documentation.