event.go

package ilert

import (
	"encoding/json"
	"errors"
)

// Event represents the alert event https://api.ilert.com/api-docs/#tag/Events
type Event struct {
	// Required. The API key of the alert source.
	APIKey string `json:"apiKey"`

	// Required. Must be either ALERT, ACCEPT, or RESOLVE
	EventType string `json:"eventType"`

	// Required. The event summary. Will be used as the alert summary if a new alert is created.
	Summary string `json:"summary"`

	// Optional. The event details. Will be used as the alert details if a new alert is created.
	Details string `json:"details,omitempty"`

	// Optional. For ALERT events, the alert key can be used to deduplicate or group events. If an open alert with the key already exists, the event will be appended to the alert's event log. Otherwise a new alert will be created. For ACCEPT and RESOLVE events, the alert key is used to reference the open alert which is to be accepted or resolved by this event.
	AlertKey string `json:"alertKey,omitempty"`

	// Optional. For ALERT events, the alert key can be used to deduplicate or group events. If an open alert with the key already exists, the event will be appended to the alert's event log. Otherwise a new alert will be created. For ACCEPT and RESOLVE events, the alert key is used to reference the open alert which is to be accepted or resolved by this event.
	Priority string `json:"priority,omitempty"`

	// Optional. A list of images containing src, href and alt.
	Images []AlertImage `json:"images,omitempty"`

	// Optional. A list of links, containing href and text.
	Links []AlertLink `json:"links,omitempty"`

	// Optional. Additional custom details for the event.
	CustomDetails map[string]interface{} `json:"customDetails,omitempty"`
}

// EventTypes defines event types
var EventTypes = struct {
	Alert   string
	Accept  string
	Resolve string
}{
	Alert:   "ALERT",
	Accept:  "ACCEPT",
	Resolve: "RESOLVE",
}

// EventResponse describes event API response body
type EventResponse struct {
	AlertKey     string `json:"alertKey"`
	AlertURL     string `json:"alertUrl"`
	ResponseCode string `json:"responseCode"`
}

// CreateEventInput represents the input of a CreateEvent operation.
type CreateEventInput struct {
	_ struct{}
	// alert event
	Event *Event
	// (optional) request url
	URL *string
}

// CreateEventOutput represents the output of a CreateEvent operation.
type CreateEventOutput struct {
	_             struct{}
	EventResponse *EventResponse
}

// CreateEvent creates an alert event. https://api.ilert.com/api-docs/#tag/Events/paths/~1events/post
func (c *Client) CreateEvent(input *CreateEventInput) (*CreateEventOutput, error) {
	if input == nil {
		return nil, errors.New("input is required")
	}
	if input.Event == nil {
		return nil, errors.New("input event is required")
	}
	url := apiRoutes.events
	if input.URL != nil && *input.URL != "" {
		url = *input.URL
	}
	resp, err := c.httpClient.R().SetBody(input.Event).Post(url)
	if err != nil {
		return nil, err
	}
	if apiErr := getGenericAPIError(resp, 200, 202); apiErr != nil {
		return nil, apiErr
	}
	eventResponse := &EventResponse{}
	err = json.Unmarshal(resp.Body(), eventResponse)
	if err != nil {
		return nil, err
	}

	return &CreateEventOutput{EventResponse: eventResponse}, nil
}