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

httpclient

package

Go to main page

Versions in this module

v0

v0.24.0

Feb 7, 2026

v0.23.0

Jan 30, 2026

v0.22.0

Jan 13, 2026

v0.21.0

Jan 5, 2026

v0.20.0

Dec 18, 2025

v0.19.0

Dec 5, 2025

Changes in this version

+ const DefaultMaxRetries

+ const DefaultRetryDelay

+ const DefaultTimeout

+ const HeaderTraceParent

+ const HeaderTraceState

+ const HeaderXRequestID

+ func EnsureTraceID(ctx context.Context) string

+ func GenerateTraceParent() string

+ func IsErrorType(err error, errorType ErrorType) bool

+ func IsHTTPStatusError(err error, statusCode int) bool

+ func IsSuccessStatus(statusCode int) bool

+ func TraceIDFromContext(ctx context.Context) (string, bool)

+ func TraceParentFromContext(ctx context.Context) (string, bool)

+ func TraceStateFromContext(ctx context.Context) (string, bool)

+ func WithTraceID(ctx context.Context, traceID string) context.Context

+ func WithTraceParent(ctx context.Context, traceParent string) context.Context

+ func WithTraceState(ctx context.Context, traceState string) context.Context

+ type BasicAuth struct

+ Password string

+ Username string

+ type Builder struct

+ func NewBuilder(log logger.Logger) *Builder

+ func (b *Builder) Build() Client

+ func (b *Builder) WithBasicAuth(username, password string) *Builder

+ func (b *Builder) WithDefaultHeader(key, value string) *Builder

+ func (b *Builder) WithHTTPClient(client *nethttp.Client) *Builder

+ func (b *Builder) WithRequestInterceptor(interceptor RequestInterceptor) *Builder

+ func (b *Builder) WithResponseInterceptor(interceptor ResponseInterceptor) *Builder

+ func (b *Builder) WithRetries(maxRetries int, retryDelay time.Duration) *Builder

+ func (b *Builder) WithTimeout(timeout time.Duration) *Builder

+ func (b *Builder) WithTraceIDExtractor(extractor func(_ context.Context) (string, bool)) *Builder

+ func (b *Builder) WithTraceIDGenerator(gen func() string) *Builder

+ func (b *Builder) WithTraceIDHeader(name string) *Builder

+ func (b *Builder) WithTransport(transport nethttp.RoundTripper) *Builder

+ func (b *Builder) WithW3CTrace(enabled bool) *Builder

+ type Client interface

+ Delete func(ctx context.Context, req *Request) (*Response, error)

+ Do func(ctx context.Context, method string, req *Request) (*Response, error)

+ Get func(ctx context.Context, req *Request) (*Response, error)

+ Patch func(ctx context.Context, req *Request) (*Response, error)

+ Post func(ctx context.Context, req *Request) (*Response, error)

+ Put func(ctx context.Context, req *Request) (*Response, error)

+ func NewClient(log logger.Logger) Client

+ type ClientError interface

+ Type func() ErrorType

+ func NewHTTPError(message string, statusCode int, body []byte) ClientError

+ func NewInterceptorError(message, stage string, wrapped error) ClientError

+ func NewNetworkError(message string, wrapped error) ClientError

+ func NewTimeoutError(message string, timeout time.Duration) ClientError

+ func NewValidationError(message, field string) ClientError

+ type Config struct

+ BasicAuth *BasicAuth

+ DefaultHeaders map[string]string

+ EnableW3CTrace bool

+ LogPayloads bool

+ MaxPayloadLogBytes int

+ MaxRetries int

+ NewTraceID func() string

+ RequestInterceptors []RequestInterceptor

+ ResponseInterceptors []ResponseInterceptor

+ RetryDelay time.Duration

+ Timeout time.Duration

+ TraceIDExtractor func(_ context.Context) (traceID string, ok bool)

+ TraceIDHeader string

+ type ErrorType string

+ const HTTPError

+ const InterceptorError

+ const NetworkError

+ const TimeoutError

+ const ValidationError

+ type Request struct

+ Auth *BasicAuth

+ Body []byte

+ Headers map[string]string

+ URL string

+ type RequestInterceptor func(ctx context.Context, req *nethttp.Request) error

+ func NewTraceIDInterceptor() RequestInterceptor

+ func NewTraceIDInterceptorFor(header string) RequestInterceptor

+ type Response struct

+ Body []byte

+ Headers nethttp.Header

+ Stats Stats

+ StatusCode int

+ type ResponseInterceptor func(ctx context.Context, req *nethttp.Request, resp *nethttp.Response) error

+ type Stats struct

+ CallCount int64

+ ElapsedTime time.Duration