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
- API
  
  Reference documentation for the pkg.go.dev API
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

httpclient

package module

Go to main page

Versions in this module

v0

v0.0.3

Jun 6, 2026

v0.0.2

Mar 11, 2026

v0.0.1

Mar 10, 2026

Changes in this version

+ var ErrClientClosed = errors.New("http client is closed")

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

+ type Client struct

+ func New(cfg *Config, opts ...Option) (*Client, error)

+ func (c *Client) Close()

+ func (c *Client) Delete(ctx context.Context, url string, opts ...RequestOption) (*http.Response, error)

+ func (c *Client) Do(ctx context.Context, req *http.Request, reqOpts ...RequestOption) (*http.Response, error)

+ func (c *Client) Get(ctx context.Context, url string, opts ...RequestOption) (*http.Response, error)

+ func (c *Client) Head(ctx context.Context, url string, opts ...RequestOption) (*http.Response, error)

+ func (c *Client) Options(ctx context.Context, url string, opts ...RequestOption) (*http.Response, error)

+ func (c *Client) Patch(ctx context.Context, url string, contentType string, body io.Reader, ...) (*http.Response, error)

+ func (c *Client) Post(ctx context.Context, url string, contentType string, body io.Reader, ...) (*http.Response, error)

+ func (c *Client) Put(ctx context.Context, url string, contentType string, body io.Reader, ...) (*http.Response, error)

+ type Config struct

+ Headers map[string]string

+ Hooks []Hook

+ Logger Logger

+ Retry *RetryConfig

+ Telemetry *TelemetryConfig

+ Timeout time.Duration

+ Transport *http.Transport

+ func DefaultConfig() *Config

+ type ConfigError struct

+ Field string

+ Message string

+ func NewConfigError(field, message string) *ConfigError

+ func (e *ConfigError) Error() string

+ type Hook interface

+ OnError func(req *http.Request, err error)

+ OnRequestEnd func(req *http.Request, resp *http.Response)

+ OnRequestStart func(req *http.Request)

+ type Logger interface

+ Close func() error

+ Debug func(ctx context.Context, msg string, fields map[string]any)

+ Error func(ctx context.Context, msg string, fields map[string]any)

+ Info func(ctx context.Context, msg string, fields map[string]any)

+ Warn func(ctx context.Context, msg string, fields map[string]any)

+ type Option func(*Config)

+ func WithHeaders(h map[string]string) Option

+ func WithHooks(hooks ...Hook) Option

+ func WithLogger(l Logger) Option

+ func WithRetry(maxRetries int, minBackoff, maxBackoff time.Duration) Option

+ func WithTelemetry(t *TelemetryConfig) Option

+ func WithTimeout(d time.Duration) Option

+ func WithTransport(t *http.Transport) Option

+ type RequestError struct

+ Err error

+ Method string

+ URL string

+ func (e *RequestError) Error() string

+ func (e *RequestError) Unwrap() error

+ type RequestOption func(*requestOpts)

+ func WithObfuscatedHeaders(headers ...string) RequestOption

+ func WithRequestHeaders(headers http.Header) RequestOption

+ func WithSkipLog() RequestOption

+ func WithTags(tags map[string]string) RequestOption

+ func WithTraceID(traceID string) RequestOption

+ type ResponseDecodeError struct

+ Err error

+ StatusCode int

+ func (e *ResponseDecodeError) Error() string

+ func (e *ResponseDecodeError) Unwrap() error

+ type RetryConfig struct

+ MaxBackoff time.Duration

+ MaxRetries int

+ MinBackoff time.Duration

+ type TelemetryConfig struct

+ Environment string

+ OTLPEndpoint string

+ SampleAll bool

+ ServiceName string

+ Version string