105 lines
2.4 KiB
Go
105 lines
2.4 KiB
Go
// Package client provides the implementation for interacting with the WeKnora API
|
|
// This package encapsulates CRUD operations for server resources and provides a friendly interface for callers
|
|
package client
|
|
|
|
import (
|
|
"bytes"
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"io"
|
|
"net/http"
|
|
"net/url"
|
|
"time"
|
|
)
|
|
|
|
// Client is the client for interacting with the WeKnora service
|
|
type Client struct {
|
|
baseURL string
|
|
httpClient *http.Client
|
|
token string
|
|
}
|
|
|
|
// ClientOption defines client configuration options
|
|
type ClientOption func(*Client)
|
|
|
|
// WithTimeout sets the HTTP client timeout
|
|
func WithTimeout(timeout time.Duration) ClientOption {
|
|
return func(c *Client) {
|
|
c.httpClient.Timeout = timeout
|
|
}
|
|
}
|
|
|
|
// WithToken sets the authentication token
|
|
func WithToken(token string) ClientOption {
|
|
return func(c *Client) {
|
|
c.token = token
|
|
}
|
|
}
|
|
|
|
// NewClient creates a new client instance
|
|
func NewClient(baseURL string, options ...ClientOption) *Client {
|
|
client := &Client{
|
|
baseURL: baseURL,
|
|
httpClient: &http.Client{
|
|
Timeout: 30 * time.Second,
|
|
},
|
|
}
|
|
|
|
for _, option := range options {
|
|
option(client)
|
|
}
|
|
|
|
return client
|
|
}
|
|
|
|
// doRequest executes an HTTP request
|
|
func (c *Client) doRequest(ctx context.Context,
|
|
method, path string, body interface{}, query url.Values,
|
|
) (*http.Response, error) {
|
|
var reqBody io.Reader
|
|
if body != nil {
|
|
jsonData, err := json.Marshal(body)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("failed to serialize request body: %w", err)
|
|
}
|
|
reqBody = bytes.NewBuffer(jsonData)
|
|
}
|
|
|
|
url := fmt.Sprintf("%s%s", c.baseURL, path)
|
|
if len(query) > 0 {
|
|
url = fmt.Sprintf("%s?%s", url, query.Encode())
|
|
}
|
|
|
|
req, err := http.NewRequestWithContext(ctx, method, url, reqBody)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("failed to create request: %w", err)
|
|
}
|
|
|
|
req.Header.Set("Content-Type", "application/json")
|
|
if c.token != "" {
|
|
req.Header.Set("X-API-Key", c.token)
|
|
}
|
|
if requestID := ctx.Value("RequestID"); requestID != nil {
|
|
req.Header.Set("X-Request-ID", requestID.(string))
|
|
}
|
|
|
|
return c.httpClient.Do(req)
|
|
}
|
|
|
|
// parseResponse parses an HTTP response
|
|
func parseResponse(resp *http.Response, target interface{}) error {
|
|
defer resp.Body.Close()
|
|
|
|
if resp.StatusCode < 200 || resp.StatusCode >= 300 {
|
|
body, _ := io.ReadAll(resp.Body)
|
|
return fmt.Errorf("HTTP error %d: %s", resp.StatusCode, string(body))
|
|
}
|
|
|
|
if target == nil {
|
|
return nil
|
|
}
|
|
|
|
return json.NewDecoder(resp.Body).Decode(target)
|
|
}
|