Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

client

package

Go to main page

Versions in this module

v0

v0.0.9

Dec 16, 2025

v0.0.8

Dec 15, 2025

v0.0.3

May 16, 2025

v0.0.2

Apr 16, 2025

Changes in this version

+ const CONTENT_TYPE_FORM

+ const CONTENT_TYPE_JSON

+ const CONTENT_TYPE_MULTIPART

+ const CONTENT_TYPE_OCTET_STREAM

+ const CONTENT_TYPE_TEXT

+ const CONTENT_TYPE_XML

+ const DEFAULT_DIAL_TIMEOUT

+ const DEFAULT_EXPECT_CONTINUE_TIMEOUT

+ const DEFAULT_IDLE_CONNECTION_TIMEOUT

+ const DEFAULT_KEEP_ALIVE

+ const DEFAULT_MAX_CONNECTIONS_PER_HOST

+ const DEFAULT_MAX_IDLE_CONNECTIONS

+ const DEFAULT_MAX_IDLE_CONNECTIONS_PER_HOST

+ const DEFAULT_MAX_RETRIES

+ const DEFAULT_RESPONSE_HEADER_TIMEOUT

+ const DEFAULT_RETRY_DELAY

+ const DEFAULT_TIMEOUT

+ const DEFAULT_TLS_HANDSHAKE_TIMEOUT

+ func DecodeResponse[T any](resp *http.Response) (T, error)

+ func DefaultRetryPolicy(resp *http.Response, err error) bool

+ func DeleteAs[T any](c *Client, endpoint string, options ...ClientOption) (T, error)

+ func GetAs[T any](c *Client, endpoint string, options ...ClientOption) (T, error)

+ func NewHTTPClient(config *ClientConfig, options ...ClientOption) *http.Client

+ func PatchAs[T any](c *Client, endpoint string, body interface{}, options ...ClientOption) (T, error)

+ func PostAs[T any](c *Client, endpoint string, body interface{}, options ...ClientOption) (T, error)

+ func PutAs[T any](c *Client, endpoint string, body interface{}, options ...ClientOption) (T, error)

+ func RequestAs[T any](c *Client, method, endpoint string, body interface{}, options ...ClientOption) (T, error)

+ type Client struct

+ Config ClientConfig

+ HTTPClient *http.Client

+ func NewClient(options ...ClientOption) *Client

+ func (c *Client) Delete(endpoint string, options ...ClientOption) (map[string]interface{}, error)

+ func (c *Client) Get(endpoint string, options ...ClientOption) (map[string]interface{}, error)

+ func (c *Client) GetBytes(endpoint string, options ...ClientOption) ([]byte, error)

+ func (c *Client) GetString(endpoint string, options ...ClientOption) (string, error)

+ func (c *Client) Patch(endpoint string, body interface{}, options ...ClientOption) (map[string]interface{}, error)

+ func (c *Client) Post(endpoint string, body interface{}, options ...ClientOption) (map[string]interface{}, error)

+ func (c *Client) Put(endpoint string, body interface{}, options ...ClientOption) (map[string]interface{}, error)

+ func (c *Client) Request(method, endpoint string, body interface{}, options ...ClientOption) (*http.Response, error)

+ func (c *Client) SetBasicAuth(username, password string) *Client

+ func (c *Client) SetBearerToken(token string) *Client

+ func (c *Client) SetContentType(contentType string) *Client

+ func (c *Client) SetHeader(key string, values ...string) *Client

+ func (c *Client) SetQueryParam(key, value string) *Client

+ type ClientConfig struct

+ BaseURL string

+ ContentType string

+ DialTimeout time.Duration

+ ErrorResult interface{}

+ ExpectContinueTimeout time.Duration

+ Headers map[string][]string

+ IdleConnectionTimeout time.Duration

+ KeepAlive time.Duration

+ MaxConnsPerHost int

+ MaxIdleConnections int

+ MaxIdleConnsPerHost int

+ MaxRetries int

+ Password string

+ QueryParams map[string]string

+ ResponseHeaderTimeout time.Duration

+ RetryDelay time.Duration

+ RetryPolicy RetryPolicy

+ TLSHandshakeTimeout time.Duration

+ Timeout time.Duration

+ Token string

+ TokenType string

+ Username string

+ func NewDefaultConfig(options ...ClientOption) *ClientConfig

+ type ClientOption func(*ClientConfig)

+ func NoRetry() ClientOption

+ func WithBaseURL(url string) ClientOption

+ func WithBasicAuth(username, password string) ClientOption

+ func WithBearerToken(token string) ClientOption

+ func WithContentType(contentType string) ClientOption

+ func WithCustomToken(tokenType, token string) ClientOption

+ func WithDialTimeout(timeout time.Duration) ClientOption

+ func WithErrorResult(result interface{}) ClientOption

+ func WithExpectContinueTimeout(timeout time.Duration) ClientOption

+ func WithFormContentType() ClientOption

+ func WithHeader(key string, values ...string) ClientOption

+ func WithHeaders(headers map[string][]string) ClientOption

+ func WithIdleConnectionTimeout(timeout time.Duration) ClientOption

+ func WithJSONContentType() ClientOption

+ func WithKeepAlive(keepAlive time.Duration) ClientOption

+ func WithMaxConnectionsPerHost(max int) ClientOption

+ func WithMaxIdleConnections(max int) ClientOption

+ func WithMaxIdleConnectionsPerHost(max int) ClientOption

+ func WithMaxRetries(max int) ClientOption

+ func WithMultipartContentType() ClientOption

+ func WithQueryParam(key, value string) ClientOption

+ func WithQueryParams(params map[string]string) ClientOption

+ func WithResponseHeaderTimeout(timeout time.Duration) ClientOption

+ func WithRetryDelay(delay time.Duration) ClientOption

+ func WithRetryPolicy(policy RetryPolicy) ClientOption

+ func WithTLSHandshakeTimeout(timeout time.Duration) ClientOption

+ func WithTimeout(timeout time.Duration) ClientOption

+ type RetryPolicy func(resp *http.Response, err error) bool

+ type StatusCode int