Debian Codegraph @

pkg/services/push/gotify/gotify_url.go

raw
1 package gotify
2
3 import "net/url"
4
5 // URLBuilder handles URL construction for Gotify API endpoints.
6 type URLBuilder interface {
7 BuildURL(config *Config) (string, error)
8 }
9
10 // DefaultURLBuilder provides the default implementation of URLBuilder.
11 type DefaultURLBuilder struct{}
12
13 // BuildURL constructs the Gotify API URL with scheme, host, path, and token.
14 // This function builds the complete endpoint URL for the Gotify message API, handling
15 // different authentication methods (header vs query parameter) and TLS settings.
16 // The URL format depends on whether header authentication is enabled.
17 // Parameters:
18 // - config: Configuration containing host, path, token, and authentication settings
19 //
20 // Returns: complete API URL string.
21 func (b *DefaultURLBuilder) BuildURL(config *Config) (string, error) {
22 // Determine URL scheme based on TLS settings
23 scheme := "https"
24 if config.DisableTLS {
25 scheme = "http" // Use HTTP scheme when TLS verification is disabled
26 }
27
28 // Construct URL using url.URL for proper encoding
29 apiURL := &url.URL{
30 Scheme: scheme,
31 Host: config.Host,
32 Path: config.Path + "/message",
33 }
34
35 if !config.UseHeader {
36 // Query parameter authentication: include token in URL query string
37 q := apiURL.Query()
38 q.Set("token", config.Token)
39 apiURL.RawQuery = q.Encode()
40 }
41
42 return apiURL.String(), nil
43 }