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

httpreq

package module

Go to main page

Versions in this module

v0

v0.2.0

Jul 3, 2026

Changes in this version

+ const DefaultUserAgent

+ const Version

+ func Curl(ctx context.Context, endpoint string, opts ...Option) (string, error)

+ func RequestCurl(req *http.Request) (string, error)

+ func SlogObserver(l *slog.Logger, level slog.Level) func(context.Context, Trace)

type Option

+ func WithBasicAuth(user, password string) Option

+ func WithConnTrace() Option

+ func WithCurl(fn func(curl string)) Option

+ func WithErrorInto(v any) Option

+ func WithExpectStatus(codes ...int) Option

+ func WithFormBody(values url.Values) Option

+ func WithHeaders(h http.Header) Option

+ func WithObserver(fn func(context.Context, Trace)) Option

+ func WithQuery(q url.Values) Option

+ func WithRequest(fn func(*http.Request) error) Option

+ func WithResponseBytes(b *[]byte) Option

+ func WithResponseWriter(w io.Writer) Option

+ func WithUserAgent(ua string) Option

+ type Trace struct

+ Attempt int

+ Connect time.Duration

+ DNS time.Duration

+ Duration time.Duration

+ Err error

+ Method string

+ ReqBytes int

+ RespBytes int

+ StatusCode int

+ TLS time.Duration

+ TTFB time.Duration

+ URL string

v0.1.0

May 2, 2026

Changes in this version

+ func Do(ctx context.Context, endpoint string, opts ...Option) (*http.Response, error)

+ type HTTPError struct

+ Body []byte

+ Status string

+ StatusCode int

+ func (e *HTTPError) Error() string

+ type Option func(*request) error

+ func WithBearerToken(token string) Option

+ func WithHTTPClient(c *http.Client) Option

+ func WithHeader(key, value string) Option

+ func WithJSONBody(body any) Option

+ func WithMethod(m string) Option

+ func WithQueryParam(key, value string) Option

+ func WithRawBody(body []byte) Option

+ func WithResponseInto(v any) Option

+ func WithTimeout(d time.Duration) Option