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

httputil

package

Go to main page

Versions in this module

v0

v0.0.4

Jun 25, 2026

Changes in this version

+ type BindOption func(*bindOptions)

+ func WithMaxBytes(n int64) BindOption

type Router

+ func (r *Router) HandleFunc(methodPattern string, handler http.HandlerFunc)

+ func (r *Router) ServeHTTP(w http.ResponseWriter, req *http.Request)

v0.0.4-dev.2

Jun 20, 2026

v0.0.4-dev.1

May 27, 2026

v0.0.4-dev.0

Apr 30, 2026

v0.0.3

Feb 15, 2026

v0.0.2

Jan 18, 2026

Changes in this version

+ func BasicAuthUser(r *http.Request) (string, bool)

+ func Bind(r *http.Request, dst any) error

+ func BindOrError(r *http.Request, w http.ResponseWriter, dst any) error

+ func Blob(w http.ResponseWriter, statusCode int, data []byte, contentType string)

+ func Conn(r *http.Request) (map[string]any, *pgxpool.Conn, *pgconn.PgError)

+ func ConnWithRole(r *http.Request) (map[string]any, *pgxpool.Conn, *pgconn.PgError)

+ func Error(w http.ResponseWriter, statusCode int, message string)

+ func HTML(w http.ResponseWriter, statusCode int, html string)

+ func JSON(w http.ResponseWriter, statusCode int, v any)

+ func OIDCUser(r *http.Request) (map[string]any, bool)

+ func Text(w http.ResponseWriter, statusCode int, text string)

+ type ContextKey string

+ const BasicAuthCtxKey

+ const LogEntryCtxKey

+ const OIDCRoleClaimCtxKey

+ const OIDCUserCtxKey

+ const PgConnCtxKey

+ const RequestIDCtxKey

+ type ErrorResponse struct

+ Code int

+ Message string

+ type Logger interface

+ Printf func(format string, v ...interface{})

+ type Middleware func(http.Handler) http.Handler

+ type RequestConfig struct

+ Headers map[string][]string

+ InitialBackoff time.Duration

+ Logger Logger

+ MaxBackoff time.Duration

+ MaxRetries int

+ Method string

+ ResponseHandler func(*http.Response) error

+ RetryEnabled bool

+ Timeout time.Duration

+ URL string

+ func DefaultRequestConfig(method, url string) RequestConfig

+ type Response struct

+ Body []byte

+ Headers http.Header

+ Request *http.Request

+ StatusCode int

+ func Request(ctx context.Context, config RequestConfig, payload interface{}) (*Response, error)

+ type Router struct

+ func NewRouter(opts ...RouterOptions) *Router

+ func (r *Router) Group(prefix string) *Router

+ func (r *Router) Handle(methodPattern string, handler http.Handler)

+ func (r *Router) ListenAndServe(addr string) error

+ func (r *Router) Shutdown(ctx context.Context) error

+ func (r *Router) Use(mw Middleware, additional ...Middleware)

+ type RouterOptions func(*Router)

+ func WithServerOptions(opts ...func(*http.Server)) RouterOptions

+ func WithTLS(certFile, keyFile string) RouterOptions