client v2

alert.go

@@ -146,6 +146,14 @@ var AlertLogEntryTypes = struct {
 	UserResponseLogEntry:          "UserResponseLogEntry",
 }
 
+var AlertInclude = struct {
+	EscalationRules    string
+	NextEscalationUser string
+}{
+	EscalationRules:    "escalationRules",
+	NextEscalationUser: "nextEscalationUser",
+}
+
 // // AlertAction definition
 // type AlertAction struct {
 // 	Name        string              `json:"name"`
@@ -169,6 +177,9 @@ var AlertLogEntryTypes = struct {
 type GetAlertInput struct {
 	_       struct{}
 	AlertID *int64
+
+	// describes optional properties that should be included in the response
+	Include []*string
 }
 
 // GetAlertOutput represents the output of a GetAlert operation.
@@ -186,7 +197,13 @@ func (c *Client) GetAlert(input *GetAlertInput) (*GetAlertOutput, error) {
 		return nil, errors.New("Alert id is required")
 	}
 
-	resp, err := c.httpClient.R().Get(fmt.Sprintf("%s/%d", apiRoutes.alerts, *input.AlertID))
+	q := url.Values{}
+
+	for _, include := range input.Include {
+		q.Add("include", *include)
+	}
+
+	resp, err := c.httpClient.R().Get(fmt.Sprintf("%s/%d?%s", apiRoutes.alerts, *input.AlertID, q.Encode()))
 	if err != nil {
 		return nil, err
 	}

examples/alert/main.go

@@ -4,11 +4,11 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {
-	var apiToken = "your API token"
+	var apiToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJpbGVydCIsImlsX3QiOiJBUEkiLCJpbF92IjoxLCJpbF9rIjoiOGQ1ODU3NGY5Y2FhNGFlNGE2YmE1ZDVkZjRlNzgzZjYifQ.7rcm1EyqMNmLuuZ1v40ME5eiDL4T0QYGdfaxMQCQ_jY"
 	client := ilert.NewClient(ilert.WithAPIToken(apiToken))
 	result, err := client.GetAlerts(&ilert.GetAlertsInput{
 		States: []*string{ilert.String(ilert.AlertStatuses.Accepted)},
@@ -22,4 +22,12 @@ func main() {
 		log.Println(fmt.Sprintf("%+v\n", *alert))
 	}
 
+	// id := int64(your alert id)
+	// input := &ilert.GetAlertInput{Include: []*string{ilert.String("escalationRules")}, AlertID: &id}
+	// result, err := client.GetAlert(input)
+	// if err != nil {
+	// 	log.Println(result)
+	// 	log.Fatalln("ERROR:", err)
+	// }
+	// log.Println(fmt.Sprintf("%+v\n", *result.Alert))
 }

examples/alertaction/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/alertsource/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/automationrules/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/connectors/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/escalationpolicy/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/event/main.go

@@ -5,7 +5,7 @@ import (
 	"os"
 	"time"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/heartbeat/main.go

@@ -3,7 +3,7 @@ package main
 import (
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/incidents/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/incidenttemplate/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/number/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/schedules/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/services/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/statuspages/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/uptimemonitor/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

examples/user/main.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"log"
 
-	"github.com/iLert/ilert-go"
+	"github.com/iLert/ilert-go/v2"
 )
 
 func main() {

go.mod

@@ -1,4 +1,4 @@
-module github.com/iLert/ilert-go
+module github.com/iLert/ilert-go/v2
 
 go 1.16
 

incident.go

@@ -208,6 +208,7 @@ type GetIncidentInput struct {
 type GetIncidentOutput struct {
 	_        struct{}
 	Incident *Incident
+	ETag     *string
 }
 
 // GetIncident gets an incident by ID. https://api.ilert.com/api-docs/#tag/Incidents/paths/~1incidents~1{id}/get
@@ -241,7 +242,13 @@ func (c *Client) GetIncident(input *GetIncidentInput) (*GetIncidentOutput, error
 		return nil, err
 	}
 
-	return &GetIncidentOutput{Incident: incident}, nil
+	output := &GetIncidentOutput{Incident: incident}
+	etag := resp.Header().Get("ETag")
+	if etag != "" {
+		output.ETag = String(etag)
+	}
+
+	return output, nil
 }
 
 // GetIncidentSubscribersInput represents the input of a GetIncidentSubscribers operation.
@@ -372,6 +379,7 @@ type UpdateIncidentInput struct {
 	_          struct{}
 	IncidentID *int64
 	Incident   *Incident
+	ETag       *string
 }
 
 // UpdateIncidentOutput represents the output of a UpdateIncident operation.
@@ -394,7 +402,11 @@ func (c *Client) UpdateIncident(input *UpdateIncidentInput) (*UpdateIncidentOutp
 
 	url := fmt.Sprintf("%s/%d", apiRoutes.incidents, *input.IncidentID)
 
-	resp, err := c.httpClient.R().SetBody(input.Incident).Put(url)
+	req := c.httpClient.R()
+	if input.ETag != nil && *input.ETag != "" {
+		req.SetHeader("If-Match", *input.ETag)
+	}
+	resp, err := req.SetBody(input.Incident).Put(url)
 	if err != nil {
 		return nil, err
 	}

version.go

@@ -1,4 +1,4 @@
 package ilert
 
 // Version package version
-const Version = "v1.6.5"
+const Version = "v2.0.0"