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.5.0

Jan 24, 2026

v0.4.2

Jan 24, 2026

v0.4.1

Jan 24, 2026

v0.4.0

Jan 19, 2026

v0.3.5

Jan 18, 2026

v0.3.4

Jan 18, 2026

v0.3.3

Jan 18, 2026

v0.3.2

Jan 17, 2026

v0.3.1

Jan 17, 2026

v0.3.0

Jan 17, 2026

v0.2.0

Jan 11, 2026

Changes in this version

+ const MethodDelete

+ const MethodGet

+ const MethodHead

+ const MethodOptions

+ const MethodPatch

+ const MethodPost

+ const MethodPut

+ var CombineRetryConditions = requests.CombineRetryConditions

+ var ExponentialRetryPolicy = requests.ExponentialRetryPolicy

+ var IsConnectionError = requests.IsConnectionError

+ var IsResponseError = requests.IsResponseError

+ var IsTemporary = requests.IsTemporary

+ var IsTimeout = requests.IsTimeout

+ var LinearRetryPolicy = requests.LinearRetryPolicy

+ var NewHooks = requests.NewHooks

+ var NewMiddlewareChain = requests.NewMiddlewareChain

+ var NoRetryPolicy = requests.NoRetryPolicy

+ var RetryOn5xx = requests.RetryOn5xx

+ var RetryOnNetworkError = requests.RetryOnNetworkError

+ var RetryOnStatusCodes = requests.RetryOnStatusCodes

+ var WithAccept = requests.WithAccept

+ var WithBasicAuth = requests.WithBasicAuth

+ var WithBearerToken = requests.WithBearerToken

+ var WithContentType = requests.WithContentType

+ var WithContext = requests.WithContext

+ var WithHeader = requests.WithHeader

+ var WithHeaders = requests.WithHeaders

+ var WithQuery = requests.WithQuery

+ var WithQueryParams = requests.WithQueryParams

+ var WithTimeout = requests.WithTimeout

+ func AcquireSession() requests.Session

+ func Close() error

+ func IsHTTP2Enabled() bool

+ func NewDelete(url string) *requests.RequestBuilder

+ func NewGet(url string) *requests.RequestBuilder

+ func NewPatch(url string) *requests.RequestBuilder

+ func NewPost(url string) *requests.RequestBuilder

+ func NewPut(url string) *requests.RequestBuilder

+ func NewRequestBuilder(method requests.Method, url string) *requests.RequestBuilder

+ func ReleaseSession(sess requests.Session)

+ func SetHTTP2Enabled(enabled bool)

+ type Handler = requests.Handler

+ type Hooks = requests.Hooks

+ type Method = requests.Method

+ type Middleware = requests.Middleware

+ type MiddlewareChain = requests.MiddlewareChain

+ type Pool struct

+ func GetDefaultPool() *Pool

+ func NewPool(config PoolConfig) *Pool

+ func NewPoolWithDefaults() *Pool

+ func (p *Pool) Close() error

+ func (p *Pool) GetConfig() PoolConfig

+ func (p *Pool) GetSession() requests.Session

+ func (p *Pool) GetStats() map[string]any

+ type PoolConfig struct

+ ConnectTimeout time.Duration

+ EnableHTTP2 bool

+ EnableKeepAlive bool

+ IdleTimeout time.Duration

+ MaxIdleConns int

+ MaxIdleConnsPerHost int

+ MaxRetries int

+ MaxRetryDelay time.Duration

+ RetryDelay time.Duration

+ Timeout time.Duration

+ func DefaultPoolConfig() PoolConfig

+ type RequestBuilder = requests.RequestBuilder

+ type RequestOption = requests.RequestOption

+ type Response interface

+ Bytes func() []byte

+ IsError func() bool

+ IsSuccess func() bool

+ StatusCode func() int

+ Text func() string

+ func Delete(url string, opts ...RequestOption) (Response, error)

+ func DeleteWithContext(ctx context.Context, url string, opts ...RequestOption) (Response, error)

+ func Get(url string, opts ...RequestOption) (Response, error)

+ func GetWithContext(ctx context.Context, url string, opts ...RequestOption) (Response, error)

+ func Patch(url string, body any, opts ...RequestOption) (Response, error)

+ func PatchWithContext(ctx context.Context, url string, body any, opts ...RequestOption) (Response, error)

+ func Post(url string, body any, opts ...RequestOption) (Response, error)

+ func PostWithContext(ctx context.Context, url string, body any, opts ...RequestOption) (Response, error)

+ func Put(url string, body any, opts ...RequestOption) (Response, error)

+ func PutWithContext(ctx context.Context, url string, body any, opts ...RequestOption) (Response, error)

+ type Result struct

+ func DeleteJSON[T any](url string, opts ...RequestOption) (Result[T], error)

+ func GetJSON[T any](url string, opts ...RequestOption) (Result[T], error)

+ func PatchJSON[T any](url string, data any, opts ...RequestOption) (Result[T], error)

+ func PostJSON[T any](url string, data any, opts ...RequestOption) (Result[T], error)

+ func PutJSON[T any](url string, data any, opts ...RequestOption) (Result[T], error)

+ func (r Result[T]) Data() T

+ func (r Result[T]) IsSuccess() bool

+ func (r Result[T]) StatusCode() int

+ type RetryExecutor struct

+ func NewRetryExecutor(maxRetries int, retryDelay, maxRetryDelay time.Duration) *RetryExecutor

+ func NewRetryExecutorFromConfig(config PoolConfig) *RetryExecutor

+ func (r *RetryExecutor) Execute(ctx context.Context, fn func() (Response, error)) (Response, error)

+ func (r *RetryExecutor) GetAttemptCount() int

+ func (r *RetryExecutor) GetMaxRetries() int