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

httpc

package module

Go to main page

Versions in this module

v1

v1.0.0

Jan 11, 2026

v0

v0.1.0

Jan 11, 2026

Changes in this version

+ var ErrCircuitOpen = errors.New("circuit breaker is open")

+ var ErrClientError = errors.New("client error")

+ var ErrRateLimited = errors.New("rate limit exceeded")

+ var ErrRetryExhausted = errors.New("retry attempts exhausted")

+ var ErrServerError = errors.New("server error")

+ var ErrTimeout = errors.New("request timeout")

+ type AdaptiveRateLimiter struct

+ func NewAdaptiveRateLimiter(minRate, maxRate float64) *AdaptiveRateLimiter

+ func (a *AdaptiveRateLimiter) CurrentRate() float64

+ func (a *AdaptiveRateLimiter) RecordFailure()

+ func (a *AdaptiveRateLimiter) RecordSuccess()

+ func (a *AdaptiveRateLimiter) Wait(ctx context.Context) error

+ type BearerTokenFunc func() (string, error)

+ type CircuitBreakerConfig struct

+ Interval time.Duration

+ MaxFailures int

+ MaxRequests int

+ Name string

+ OnStateChange func(name string, from, to gobreaker.State)

+ Timeout time.Duration

+ func DefaultCircuitBreakerConfig() *CircuitBreakerConfig

+ func NewCircuitBreakerConfig(opts ...CircuitBreakerOption) *CircuitBreakerConfig

+ type CircuitBreakerOption func(*CircuitBreakerConfig)

+ func WithCircuitBreakerInterval(d time.Duration) CircuitBreakerOption

+ func WithCircuitBreakerMaxRequests(n int) CircuitBreakerOption

+ func WithCircuitBreakerName(name string) CircuitBreakerOption

+ func WithCircuitBreakerStateChange(fn func(name string, from, to gobreaker.State)) CircuitBreakerOption

+ func WithCircuitBreakerTimeout(d time.Duration) CircuitBreakerOption

+ func WithMaxFailures(n int) CircuitBreakerOption

+ type CircuitState int

+ const CircuitClosed

+ const CircuitHalfOpen

+ const CircuitOpen

+ func (s CircuitState) String() string

+ type Client struct

+ func New() *Client

+ func (c *Client) Delete(url string) *Request

+ func (c *Client) Do(req *http.Request) (*Response, error)

+ func (c *Client) Get(url string) *Request

+ func (c *Client) Head(url string) *Request

+ func (c *Client) Options(url string) *Request

+ func (c *Client) Patch(url string) *Request

+ func (c *Client) Post(url string) *Request

+ func (c *Client) Put(url string) *Request

+ func (c *Client) Request(method, url string) *Request

+ func (c *Client) WithBaseURL(url string) *Client

+ func (c *Client) WithCircuitBreaker(maxFailures int, timeout time.Duration) *Client

+ func (c *Client) WithCircuitBreakerConfig(config *CircuitBreakerConfig) *Client

+ func (c *Client) WithHTTPClient(client *http.Client) *Client

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

+ func (c *Client) WithHeaders(headers map[string]string) *Client

+ func (c *Client) WithLogger(logger Logger) *Client

+ func (c *Client) WithMiddleware(mw Middleware) *Client

+ func (c *Client) WithRateLimiter(requestsPerSecond float64) *Client

+ func (c *Client) WithRateLimiterConfig(requestsPerSecond float64, burst int) *Client

+ func (c *Client) WithRetry(maxAttempts int, initialDelay time.Duration) *Client

+ func (c *Client) WithRetryConfig(config *RetryConfig) *Client

+ func (c *Client) WithTimeout(timeout time.Duration) *Client

+ type DefaultLogger struct

+ func NewDefaultLogger(level slog.Level) *DefaultLogger

+ func NewDefaultLoggerWithHandler(handler slog.Handler) *DefaultLogger

+ func (l *DefaultLogger) LogError(req *http.Request, err error, duration time.Duration)

+ func (l *DefaultLogger) LogRequest(req *http.Request)

+ func (l *DefaultLogger) LogResponse(req *http.Request, resp *http.Response, duration time.Duration)

+ func (l *DefaultLogger) LogRetry(req *http.Request, attempt int, delay time.Duration)

+ type Error struct

+ Err error

+ Op string

+ StatusCode int

+ URL string

+ func (e *Error) Error() string

+ func (e *Error) IsClientError() bool

+ func (e *Error) IsRetryable() bool

+ func (e *Error) IsServerError() bool

+ func (e *Error) IsTimeout() bool

+ func (e *Error) Unwrap() error

+ type ErrorHandler func(resp *Response) error

+ type HTTPHandler func(req *http.Request) (*Response, error)

+ type Handler = HTTPHandler

+ type Logger interface

+ LogError func(req *http.Request, err error, duration time.Duration)

+ LogRequest func(req *http.Request)

+ LogResponse func(req *http.Request, resp *http.Response, duration time.Duration)

+ LogRetry func(req *http.Request, attempt int, delay time.Duration)

+ type Middleware func(req *http.Request, next HTTPHandler) (*Response, error)

+ func AuthMiddleware(scheme, credentials string) Middleware

+ func BearerTokenMiddleware(token string) Middleware

+ func Chain(middlewares ...Middleware) Middleware

+ func DynamicBearerTokenMiddleware(tokenFunc BearerTokenFunc) Middleware

+ func ErrorHandlerMiddleware(handler ErrorHandler) Middleware

+ func HeadersMiddleware(headers map[string]string) Middleware

+ func LoggingMiddleware(logger Logger) Middleware

+ func RateLimiterMiddleware(limiter *rate.Limiter) Middleware

+ func RequestIDMiddleware(headerName string, idFunc func() string) Middleware

+ func ResponseHookMiddleware(hook ResponseHook) Middleware

+ func UserAgentMiddleware(userAgent string) Middleware

+ type NopLogger struct

+ func (l NopLogger) LogError(req *http.Request, err error, duration time.Duration)

+ func (l NopLogger) LogRequest(req *http.Request)

+ func (l NopLogger) LogResponse(req *http.Request, resp *http.Response, duration time.Duration)

+ func (l NopLogger) LogRetry(req *http.Request, attempt int, delay time.Duration)

+ type RateLimiterConfig struct

+ Burst int

+ RequestsPerSecond float64

+ func DefaultRateLimiterConfig() *RateLimiterConfig

+ func NewRateLimiterConfig(opts ...RateLimiterOption) *RateLimiterConfig

+ func (c *RateLimiterConfig) NewRateLimiter() *rate.Limiter

+ type RateLimiterOption func(*RateLimiterConfig)

+ func WithBurst(burst int) RateLimiterOption

+ func WithRequestsPerSecond(rps float64) RateLimiterOption

+ type Request struct

+ func (r *Request) BasicAuth(username, password string) *Request

+ func (r *Request) Bearer(token string) *Request

+ func (r *Request) Body(body io.Reader) *Request

+ func (r *Request) BodyBytes(body []byte) *Request

+ func (r *Request) BodyString(body string) *Request

+ func (r *Request) Bytes() ([]byte, error)

+ func (r *Request) Context(ctx context.Context) *Request

+ func (r *Request) DecodeJSON(v interface{}) error

+ func (r *Request) DecodeJSONResponse(v interface{}) (*Response, error)

+ func (r *Request) Do() (*Response, error)

+ func (r *Request) ExpectStatus(codes ...int) *Request

+ func (r *Request) Form(data map[string]string) *Request

+ func (r *Request) FormValues(data url.Values) *Request

+ func (r *Request) Header(key, value string) *Request

+ func (r *Request) Headers(headers map[string]string) *Request

+ func (r *Request) JSON(v interface{}) *Request

+ func (r *Request) Query(key, value string) *Request

+ func (r *Request) QueryParams(params map[string]string) *Request

+ func (r *Request) QueryValues(params url.Values) *Request

+ func (r *Request) String() (string, error)

+ func (r *Request) Timeout(timeout time.Duration) *Request

+ type Response struct

+ func (r *Response) Body() io.ReadCloser

+ func (r *Response) Bytes() ([]byte, error)

+ func (r *Response) Close() error

+ func (r *Response) ContentLength() int64

+ func (r *Response) ContentType() string

+ func (r *Response) Cookies() []*http.Cookie

+ func (r *Response) Header(key string) string

+ func (r *Response) Headers() http.Header

+ func (r *Response) IsClientError() bool

+ func (r *Response) IsError() bool

+ func (r *Response) IsServerError() bool

+ func (r *Response) IsSuccess() bool

+ func (r *Response) JSON(v interface{}) error

+ func (r *Response) Location() (string, error)

+ func (r *Response) Raw() *http.Response

+ func (r *Response) Status() string

+ func (r *Response) StatusCode() int

+ func (r *Response) String() (string, error)

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

+ type RetryConfig struct

+ InitialDelay time.Duration

+ Jitter bool

+ MaxAttempts int

+ MaxDelay time.Duration

+ Multiplier float64

+ RetryIf func(statusCode int, err error) bool

+ func DefaultRetryConfig() *RetryConfig

+ func NewRetryConfig(opts ...RetryOption) *RetryConfig

+ func (c *RetryConfig) GetDelay(attempt int) time.Duration

+ func (c *RetryConfig) ShouldRetry(statusCode int, err error) bool

+ type RetryOption func(*RetryConfig)

+ func WithInitialDelay(d time.Duration) RetryOption

+ func WithJitter(enabled bool) RetryOption

+ func WithMaxAttempts(n int) RetryOption

+ func WithMaxDelay(d time.Duration) RetryOption

+ func WithMultiplier(m float64) RetryOption

+ func WithRetryIf(fn func(statusCode int, err error) bool) RetryOption