Webhook/endpoint to create "incidents" in the system on-demand

[jayantbh]

Why do we need this ?

Currently the system relies on reverted PRs for CFR/MTTR data, only.
With support for webhooks, we might be able to link a variety of third party incident management solutions to Middleware for better Dora metrics reporting.

Should be straight-forward enough.

[xyfer17]

@jayantbh could please assign this issue to me, i would like to build this feature.

[divyanshu-dj]

@jayantbh I was researching the webhook implementation and just need a quick clarification: what specific fields/parameters should we expect from third-party systems for each incident? (I'm thinking incident ID, severity, description, detected timestamp).

[adnanhashmi09]

#562 (comment)

Please check out the guidelines in this issue. These two issues are very similar in implementation and would largely use the similar services and APIs that one of these issue end up implementing. So before we begin the implementation it is better to have the approach well discussed and documented here. This is a rather challenging and time taking task.

As for the what request body we want from the user, you can read through the incident service to get a better understanding of our system.

[jayantbh]

@xyfer17 @divyanshu-dj ^ the linked comment will offer much needed context.