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

httpc

package module

Go to main page

Versions in this module

v0

v0.3.2

Jun 10, 2026

v0.3.1

Jan 12, 2026

v0.3.0

Dec 24, 2025

Changes in this version

+ type BytesBodyError []byte

+ func (e BytesBodyError) Error() string

type Client

+ func (c *Client) Close() error

+ type ClientOption func(cfg *Config)

+ func WithH3Transport(t *http3.Transport) ClientOption

+ func WithHttp3() ClientOption

+ func WithMemoryPooling() ClientOption

+ func WithRespOption(opt RespOption) ClientOption

type Config

+ H3Transport *http3.Transport

+ MemoryPooling bool

+ Shutdowns []func() error

+ type JSONBodyError map[string]any

+ func (e JSONBodyError) Error() string

type RespOption

+ func WithNon2xxError() RespOption

+ func WithStatusCodeRange(lower, upper int) RespOption

v0.2.1

Aug 8, 2024

v0.2.0

Jun 18, 2024

Changes in this version

+ const DefaultTimeout

+ var DefaultTransport = &http.Transport

+ type BytesErrorBody []byte

+ func (e BytesErrorBody) Error() string

+ type Client struct

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

+ func (c *Client) AddOptions(opts ...Option)

+ func (c *Client) DoReq(req *http.Request, opts ...RespOption) (*http.Response, error)

+ func (c *Client) Extend(opts ...Option) *Client

+ func (c *Client) JSON(req *http.Request, obj any, opts ...RespOption) (*http.Response, error)

+ func (c *Client) Stream(req *http.Request, w io.Writer) (int64, error)

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

+ type Config struct

+ CheckRedirect func(req *http.Request, via []*http.Request) error

+ Jar http.CookieJar

+ JsonUnmarshal JsonUnmarshaler

+ Timeout time.Duration

+ Transport *http.Transport

+ type ErrorHandler func(c *Client, resp *http.Response, body []byte) error

+ type HeaderLayer struct

+ func (h *HeaderLayer) RoundTrip(req *http.Request) (*http.Response, error)

+ type JSONErrorBody map[string]any

+ func (e JSONErrorBody) Error() string

+ type JsonUnmarshaler func(data []byte, obj any) error

+ type Layer func(base http.RoundTripper) http.RoundTripper

+ type Option func(cfg *Config)

+ func WithBytesError() Option

+ func WithCheckRedirect(fn func(req *http.Request, via []*http.Request) error) Option

+ func WithCookieJar(jar http.CookieJar) Option

+ func WithCustomJSONError[E error]() Option

+ func WithErrorHandler(h ErrorHandler) Option

+ func WithHeaders(h http.Header) Option

+ func WithJSONError() Option

+ func WithLayer(l Layer) Option

+ func WithTimeout(t time.Duration) Option

+ func WithTransport(t *http.Transport) Option

+ type RespOption func(c *Client, resp *http.Response, body []byte) error

+ func WithCopy(w io.Writer) RespOption

+ func WithJSON(obj any) RespOption

+ func WithStatusCode(code int) RespOption

v0.1.0

Jun 10, 2024