OS1 Services
Webhooks
5min
introduction the webhook service provides a simple, streamlined, and reliable conduit between the event publishers and subscribers for publishers , developers of services that generate events, it offers an efficient way to broadcast these events without complex integrations like kafka streams on the other hand, subscribers , mainly app developers, can easily subscribe to these events, enabling real time responsiveness in their applications this service simplifies the process of sending and receiving event notifications, ensuring seamless and real time data flow between publishers and subscribers how it works here's a brief overview of the process create app configuration apps that want to act as publishers need to register using two details their permission requirements for subscribers and a name that subscribers will use to identify the app event registration publishers register their events with the webhook service, detailing the events they will broadcast event subscriptions consumer apps can retrieve and subscribe to registered events and specify which event types they want updates on processing and filtering the webhook service processes events, applies necessary filters, and forwards only the relevant events to the subscribers' specified webhook endpoints customizable subscriptions subscriptions can be customized to include either core, custom, or both attributes of the events reliable delivery the service ensures reliable delivery of events, managing retries and backoffs effectively in case of any delivery issues to guarantee that events reach their intended destinations apis app configurations createappconfig registers configuration for an app publishing events getappconfigdetails retrieves the configuration details for registered apps updateappconfig updates configuration details for an app events registration apis for publishers registerevents register multiple event configurations getpublisherevents retrieve all registered events updatepublisherevents update details and configurations of specific events bulkdeleteevents facilitate bulk deletion of registered events subscriptions apis for consumers createsubscription create a new subscription to webhook notifications for specific getsubscriptions retrieve a paginated list of subscriptions for an application updatesubscription update configurations of an existing subscription getsubscriptionbyid fetch details of a specific subscription using its id updatesubscriptionsevents add or remove events from an existing subscription getsubscriptionsexecutions obtain a paginated list of executions for a specific subscription