ACLP : Webhook alert channels

monitor_alert_channels.go

@@ -11,7 +11,22 @@ import (
 type AlertNotificationType string
 
 const (
-	EmailAlertNotification AlertNotificationType = "email"
+	EmailAlertNotification   AlertNotificationType = "email"
+	WebhookAlertNotification AlertNotificationType = "webhook"
+)
+
+type WebhookAuthenticationType string
+
+const (
+	WebhookAuthenticationTypeNone  WebhookAuthenticationType = "none"
+	WebhookAuthenticationTypeBasic WebhookAuthenticationType = "basic"
+)
+
+type WebhookDataCompressionType string
+
+const (
+	WebhookDataCompressionNone WebhookDataCompressionType = "none"
+	WebhookDataCompressionGZIP WebhookDataCompressionType = "gzip"
 )
 
 type AlertChannelType string
@@ -44,8 +59,8 @@ type AlertsInfo struct {
 
 // ChannelDetails represents the details block for an AlertChannel
 type ChannelDetails struct {
-	Email *EmailChannelDetails `json:"email"`
-	// Other channel types could be added here
+	Email   *EmailChannelDetails   `json:"email"`
+	Webhook *WebhookChannelDetails `json:"webhook"`
 }
 
 // EmailChannelDetails represents email-specific details for a channel
@@ -54,6 +69,33 @@ type EmailChannelDetails struct {
 	RecipientType string   `json:"recipient_type"`
 }
 
+// WebhookChannelDetails represents webhook-specific details for a channel.
+type WebhookChannelDetails struct {
+	EndpointURL              string                                  `json:"endpoint_url"`
+	Authentication           WebhookChannelAuthenticationDetails     `json:"authentication"`
+	DataCompression          WebhookDataCompressionType              `json:"data_compression"`
+	ClientCertificateDetails *WebhookChannelClientCertificateDetails `json:"client_certificate_details"`
+	CustomHeaders            []WebhookChannelCustomHeader            `json:"custom_headers"`
+}
+
+// WebhookChannelAuthenticationDetails represents webhook authentication details in responses.
+type WebhookChannelAuthenticationDetails struct {
+	Type WebhookAuthenticationType `json:"type"`
+}
+
+// WebhookChannelClientCertificateDetails represents webhook mTLS certificate details in responses.
+type WebhookChannelClientCertificateDetails struct {
+	TLSHostname         string `json:"tls_hostname"`
+	ClientCACertificate string `json:"client_ca_certificate"`
+	ClientCertificate   string `json:"client_certificate"`
+}
+
+// WebhookChannelCustomHeader represents a custom header used by a webhook channel.
+type WebhookChannelCustomHeader struct {
+	Name  string `json:"name"`
+	Value string `json:"value"`
+}
+
 // UnmarshalJSON implements the json.Unmarshaler interface
 func (a *AlertChannel) UnmarshalJSON(b []byte) error {
 	type Mask AlertChannel
@@ -77,8 +119,145 @@ func (a *AlertChannel) UnmarshalJSON(b []byte) error {
 	return nil
 }
 
+// AlertChannelCreateOptions represents options for creating an alert notification channel.
+type AlertChannelCreateOptions struct {
+	ChannelType AlertNotificationType      `json:"channel_type"`
+	Details     AlertChannelDetailsOptions `json:"details"`
+	Label       *string                    `json:"label,omitzero"`
+}
+
+// AlertChannelDetailsOptions represents the details configuration for an alert channel.
+type AlertChannelDetailsOptions struct {
+	Email   *EmailChannelCreateOptions   `json:"email,omitzero"`
+	Webhook *WebhookChannelCreateOptions `json:"webhook,omitzero"`
+}
+
+// EmailChannelCreateOptions represents email-specific configuration for an alert channel.
+type EmailChannelCreateOptions struct {
+	Usernames     []string `json:"usernames"`
+	RecipientType *string  `json:"recipient_type,omitzero"`
+}
+
+// WebhookChannelCreateOptions represents webhook-specific configuration for an alert channel.
+type WebhookChannelCreateOptions struct {
+	EndpointURL              string                                        `json:"endpoint_url"`
+	Authentication           *WebhookChannelAuthenticationCreateOptions    `json:"authentication,omitzero"`
+	DataCompression          *WebhookDataCompressionType                   `json:"data_compression,omitzero"`
+	ClientCertificateDetails *WebhookChannelClientCertificateCreateOptions `json:"client_certificate_details,omitzero"`
+	CustomHeaders            []WebhookChannelCustomHeader                  `json:"custom_headers,omitzero"`
+}
+
+// WebhookChannelAuthenticationCreateOptions represents webhook authentication options for create requests.
+type WebhookChannelAuthenticationCreateOptions struct {
+	Type    *WebhookAuthenticationType                `json:"type,omitzero"`
+	Details *WebhookChannelAuthenticationBasicDetails `json:"details,omitzero"`
+}
+
+// WebhookChannelAuthenticationBasicDetails represents webhook basic auth credentials.
+type WebhookChannelAuthenticationBasicDetails struct {
+	BasicAuthenticationUser     string `json:"basic_authentication_user"`
+	BasicAuthenticationPassword string `json:"basic_authentication_password"`
+}
+
+// WebhookChannelClientCertificateCreateOptions represents webhook mTLS certificate options for create requests.
+type WebhookChannelClientCertificateCreateOptions struct {
+	TLSHostname         *string `json:"tls_hostname,omitzero"`
+	ClientCACertificate string  `json:"client_ca_certificate"`
+	ClientCertificate   string  `json:"client_certificate"`
+	ClientPrivateKey    string  `json:"client_private_key"`
+}
+
+// VerifyWebhookRequest represents the request payload for verifying a webhook endpoint.
+type VerifyWebhookRequest struct {
+	Webhook WebhookChannelCreateOptions `json:"webhook"`
+}
+
+// VerifyWebhookResponseResult holds the verification result for a webhook.
+type VerifyWebhookResponseResult struct {
+	HTTPStatus int    `json:"http_status"`
+	Response   string `json:"response"`
+}
+
+// VerifyWebhookResponse represents the API response for webhook verification.
+type VerifyWebhookResponse struct {
+	Webhook VerifyWebhookResponseResult `json:"webhook"`
+}
+
+// AlertChannelUpdateOptions represents options for updating an alert notification channel.
+type AlertChannelUpdateOptions struct {
+	Details *AlertChannelUpdateDetailsOptions `json:"details,omitzero"`
+	Label   *string                           `json:"label,omitzero"`
+}
+
+// AlertChannelUpdateDetailsOptions represents update details for an alert channel.
+type AlertChannelUpdateDetailsOptions struct {
+	Email   *EmailChannelUpdateOptions   `json:"email,omitzero"`
+	Webhook *WebhookChannelUpdateOptions `json:"webhook,omitzero"`
+}
+
+// EmailChannelUpdateOptions represents email-specific update configuration for an alert channel.
+type EmailChannelUpdateOptions struct {
+	Usernames []string `json:"usernames,omitzero"`
+}
+
+// WebhookChannelUpdateOptions represents webhook-specific update configuration for an alert channel.
+type WebhookChannelUpdateOptions struct {
+	EndpointURL              *string                                       `json:"endpoint_url,omitzero"`
+	Authentication           *WebhookChannelAuthenticationCreateOptions    `json:"authentication,omitzero"`
+	DataCompression          *WebhookDataCompressionType                   `json:"data_compression,omitzero"`
+	ClientCertificateDetails *WebhookChannelClientCertificateCreateOptions `json:"client_certificate_details,omitzero"`
+	CustomHeaders            []WebhookChannelCustomHeader                  `json:"custom_headers,omitzero"`
+}
+
+// Alert represents an alert definition assigned to a notification channel.
+type Alert struct {
+	ID          int    `json:"id"`
+	Label       string `json:"label"`
+	ServiceType string `json:"service_type"`
+	Type        string `json:"type"`
+	URL         string `json:"url"`
+}
+
 // ListAlertChannels gets a paginated list of Alert Channels.
 func (c *Client) ListAlertChannels(ctx context.Context, opts *ListOptions) ([]AlertChannel, error) {
 	endpoint := formatAPIPath("monitor/alert-channels")
 	return getPaginatedResults[AlertChannel](ctx, c, endpoint, opts)
 }
+
+// GetAlertChannel retrieves a single Alert Channel by ID.
+func (c *Client) GetAlertChannel(ctx context.Context, channelID int) (*AlertChannel, error) {
+	endpoint := formatAPIPath("monitor/alert-channels/%d", channelID)
+	return doGETRequest[AlertChannel](ctx, c, endpoint)
+}
+
+// CreateAlertChannel creates a new alert notification channel.
+func (c *Client) CreateAlertChannel(ctx context.Context, opts AlertChannelCreateOptions) (*AlertChannel, error) {
+	endpoint := formatAPIPath("monitor/alert-channels")
+	return doPOSTRequest[AlertChannel](ctx, c, endpoint, opts)
+}
+
+// UpdateAlertChannel updates an alert notification channel.
+func (c *Client) UpdateAlertChannel(ctx context.Context, channelID int, opts AlertChannelUpdateOptions) (*AlertChannel, error) {
+	endpoint := formatAPIPath("monitor/alert-channels/%d", channelID)
+	return doPUTRequest[AlertChannel](ctx, c, endpoint, opts)
+}
+
+// DeleteAlertChannel deletes an alert notification channel.
+func (c *Client) DeleteAlertChannel(ctx context.Context, channelID int) error {
+	endpoint := formatAPIPath("monitor/alert-channels/%d", channelID)
+	return doDELETERequest(ctx, c, endpoint)
+}
+
+// ListAlertsForChannel gets a paginated list of Alert Definitions for a specific alert notification channel.
+func (c *Client) ListAlertsForChannel(ctx context.Context, channelID int, opts *ListOptions) ([]Alert, error) {
+	endpoint := formatAPIPath("monitor/alert-channels/%d/alerts", channelID)
+	return getPaginatedResults[Alert](ctx, c, endpoint, opts)
+}
+
+// VerifyAlertChannel validates a webhook endpoint.
+func (c *Client) VerifyAlertChannel(ctx context.Context, opts WebhookChannelCreateOptions) (*VerifyWebhookResponse, error) {
+	endpoint := formatAPIPath("monitor/alert-channels/verify")
+	req := VerifyWebhookRequest{Webhook: opts}
+
+	return doPOSTRequest[VerifyWebhookResponse](ctx, c, endpoint, req)
+}