httpclient

package

Go to main page

Versions in this module

v1

v1.3.2

Mar 13, 2026

v1.3.1

Mar 10, 2026

v1.3.0

Mar 10, 2026

v1.2.1

Mar 10, 2026

v1.2.0

Mar 9, 2026

v1.1.1

Mar 9, 2026

v1.1.0

Mar 9, 2026

Changes in this version

type Client

+ func DefaultClient() *Client

+ func ResetDefault(opts ...Option) *Client

+ func (c *Client) Do(ctx context.Context, method, url string, body io.Reader) (*Response, error)

+ func (c *Client) HTTPClient() *http.Client

+ func (c *Client) Transport() http.RoundTripper

type ClientOptions

+ HTTPClient *http.Client

+ func DefaultOptions() ClientOptions

+ type Option func(*ClientOptions)

+ func WithBaseURL(baseURL string) Option

+ func WithCircuitBreaker(cfg *CircuitBreakerConfig) Option

+ func WithCookies(cookies []*http.Cookie) Option

+ func WithDebug(debug *DebugConfig) Option

+ func WithExtraHeaders(headers map[string]string) Option

+ func WithHTTPClient(client *http.Client) Option

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

+ func WithInterceptors(interceptors ...Interceptor) Option

+ func WithLogger(logger Logger) Option

+ func WithMetrics(metrics Metrics) Option

+ func WithMiddlewares(middlewares ...Middleware) Option

+ func WithPool(cfg *PoolConfig) Option

+ func WithProxy(proxy func(*http.Request) (*url.URL, error)) Option

+ func WithRateLimiter(rateLimiter RateLimiter) Option

+ func WithRetry(cfg *RetryConfig) Option

+ func WithTLS(cfg *tls.Config) Option

+ func WithTimeout(timeout time.Duration) Option

+ func WithTransport(transport http.RoundTripper) Option

+ func WithUserAgent(ua string) Option

type Response

+ func DeleteContext(ctx context.Context, url string) (*Response, error)

+ func GetContext(ctx context.Context, url string) (*Response, error)

+ func PatchContext(ctx context.Context, url string, body io.Reader) (*Response, error)

+ func PostContext(ctx context.Context, url string, body io.Reader) (*Response, error)

+ func PutContext(ctx context.Context, url string, body io.Reader) (*Response, error)

v1.0.2

Dec 24, 2025

Changes in this version

+ var ErrCircuitHalfOpenLimited = errors.New("circuit breaker half-open request limit reached")

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

v1.0.1-beta.1

Oct 22, 2025

v1.0.0

Jul 25, 2025

Changes in this version

+ func SetBaseURL(baseURL string)

+ func SetDefaultClient(client *Client)

+ func SetHeader(key, value string)

+ func SetHeaders(headers map[string]string)

+ func SetTimeout(timeout time.Duration)

+ type CircuitBreaker interface

+ Execute func(func() error) error

+ State func() string

+ type CircuitBreakerConfig struct

+ FailureThreshold uint32

+ Interval time.Duration

+ MaxRequests uint32

+ SuccessThreshold uint32

+ Timeout time.Duration

+ type Client struct

+ func GetDefaultClient() *Client

+ func NewClient() *Client

+ func NewClientWithOptions(opts ClientOptions) *Client

+ func (c *Client) AddCookie(cookie *http.Cookie)

+ func (c *Client) AddInterceptor(interceptor Interceptor)

+ func (c *Client) AddMiddleware(middleware Middleware)

+ func (c *Client) Delete(url string) (*Response, error)

+ func (c *Client) DisableDebug()

+ func (c *Client) EnableDebug()

+ func (c *Client) Get(url string) (*Response, error)

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

+ func (c *Client) Patch(url string, body io.Reader) (*Response, error)

+ func (c *Client) PatchJSON(url string, data interface{}) (*Response, error)

+ func (c *Client) Post(url string, body io.Reader) (*Response, error)

+ func (c *Client) PostJSON(url string, data interface{}) (*Response, error)

+ func (c *Client) Put(url string, body io.Reader) (*Response, error)

+ func (c *Client) PutJSON(url string, data interface{}) (*Response, error)

+ func (c *Client) SetBaseURL(baseURL string)

+ func (c *Client) SetDebug(debug *DebugConfig)

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

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

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

+ type ClientOptions struct

+ BaseURL string

+ CircuitBreaker *CircuitBreakerConfig

+ Cookies []*http.Cookie

+ Debug *DebugConfig

+ Headers map[string]string

+ Interceptors []Interceptor

+ Logger Logger

+ Metrics Metrics

+ Middlewares []Middleware

+ Pool *PoolConfig

+ Proxy func(*http.Request) (*url.URL, error)

+ RateLimiter RateLimiter

+ Retry *RetryConfig

+ TLS *tls.Config

+ Timeout time.Duration

+ UserAgent string

+ type DebugConfig struct

+ Enabled bool

+ LogRequestBody bool

+ LogRequestHeaders bool

+ LogResponseBody bool

+ LogResponseHeaders bool

+ MaxBodySize int

+ SensitiveHeaders []string

+ func DefaultDebugConfig() *DebugConfig

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

+ type Logger interface

+ Debug func(msg string, fields ...interface{})

+ Error func(msg string, fields ...interface{})

+ Info func(msg string, fields ...interface{})

+ Warn func(msg string, fields ...interface{})

+ type Metrics interface

+ AddHistogram func(name string, value float64, labels map[string]string)

+ IncCounter func(name string, labels map[string]string)

+ SetGauge func(name string, value float64, labels map[string]string)

+ type Middleware func(next http.RoundTripper) http.RoundTripper

+ func LoggingMiddleware(logger Logger) Middleware

+ func MetricsMiddleware(metrics Metrics) Middleware

+ func RetryMiddleware(config RetryConfig) Middleware

+ type PoolConfig struct

+ DisableCompression bool

+ DisableKeepAlives bool

+ IdleConnTimeout time.Duration

+ MaxConnsPerHost int

+ MaxIdleConns int

+ MaxIdleConnsPerHost int

+ type RateLimiter interface

+ Allow func() bool

+ Wait func(ctx context.Context) error

+ type Request struct

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

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

+ func (r *Request) Cookie(cookie *http.Cookie) *Request

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

+ func (r *Request) Form(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(data interface{}) *Request

+ func (r *Request) Retries(retries int) *Request

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

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

+ type Response struct

+ Body []byte

+ Duration time.Duration

+ Headers http.Header

+ Request *http.Request

+ Response *http.Response

+ Status string

+ StatusCode int

+ func Delete(url string) (*Response, error)

+ func Get(url string) (*Response, error)

+ func Patch(url string, body io.Reader) (*Response, error)

+ func PatchJSON(url string, data interface{}) (*Response, error)

+ func Post(url string, body io.Reader) (*Response, error)

+ func PostJSON(url string, data interface{}) (*Response, error)

+ func Put(url string, body io.Reader) (*Response, error)

+ func PutJSON(url string, data interface{}) (*Response, error)

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

+ func (r *Response) Error() string

+ func (r *Response) IsClientError() bool

+ func (r *Response) IsError() bool

+ func (r *Response) IsInformational() bool

+ func (r *Response) IsOK() bool

+ func (r *Response) IsRedirect() bool

+ func (r *Response) IsServerError() bool

+ func (r *Response) IsSuccess() bool

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

+ func (r *Response) String() string

+ type RetryConfig struct

+ BackoffFactor float64

+ InitialDelay time.Duration

+ MaxDelay time.Duration

+ MaxRetries int

+ RetryableErrors []error

+ RetryableStatus []int

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL