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

v1

v1.13.2

Apr 4, 2026

v1.13.1

Apr 4, 2026

v1.13.0

Mar 28, 2026

Changes in this version

+ const EventTypeClientConfigured

+ const EventTypeClientCreated

+ const EventTypeClientStarted

+ const EventTypeConfigLoaded

+ const EventTypeModifierAdded

+ const EventTypeModifierApplied

+ const EventTypeModifierRemoved

+ const EventTypeModifierSet

+ const EventTypeModuleStarted

+ const EventTypeModuleStopped

+ const EventTypeTimeoutChanged

+ const ModuleName

+ const ServiceName

+ var ErrLogFilePathRequired = errors.New("log_file_path must be specified when log_to_file is enabled")

+ var ErrNoSubjectForEventEmission = errors.New("no subject available for event emission")

+ var ErrUnsafeFilename = errors.New("URL contains no valid characters for filename after sanitization")

+ func NewHTTPClientModule() modular.Module

+ type ClientService interface

+ Client func() *http.Client

+ RequestModifier func() RequestModifierFunc

+ WithTimeout func(timeoutSeconds int) *http.Client

+ type Config struct

+ DisableCompression bool

+ DisableKeepAlives bool

+ IdleConnTimeout time.Duration

+ MaxIdleConns int

+ MaxIdleConnsPerHost int

+ RequestTimeout time.Duration

+ TLSTimeout time.Duration

+ Verbose bool

+ VerboseOptions *VerboseOptions

+ func (c *Config) Validate() error

+ type FileLogger struct

+ func NewFileLogger(baseDir string, logger modular.Logger) (*FileLogger, error)

+ func (f *FileLogger) Close() error

+ func (f *FileLogger) LogRequest(id string, data []byte) error

+ func (f *FileLogger) LogResponse(id string, data []byte) error

+ func (f *FileLogger) LogTransactionToFile(id string, reqData, respData []byte, duration time.Duration, url string) error

+ type HTTPClientModule struct

+ func (m *HTTPClientModule) AddRequestModifier(name string, modifier func(*http.Request) error)

+ func (m *HTTPClientModule) Client() *http.Client

+ func (m *HTTPClientModule) Dependencies() []string

+ func (m *HTTPClientModule) EmitEvent(ctx context.Context, event cloudevents.Event) error

+ func (m *HTTPClientModule) GetRegisteredEventTypes() []string

+ func (m *HTTPClientModule) Init(app modular.Application) error

+ func (m *HTTPClientModule) Name() string

+ func (m *HTTPClientModule) ProvidesServices() []modular.ServiceProvider

+ func (m *HTTPClientModule) RegisterConfig(app modular.Application) error

+ func (m *HTTPClientModule) RegisterObservers(subject modular.Subject) error

+ func (m *HTTPClientModule) RemoveRequestModifier(name string)

+ func (m *HTTPClientModule) RequestModifier() RequestModifierFunc

+ func (m *HTTPClientModule) RequiresServices() []modular.ServiceDependency

+ func (m *HTTPClientModule) SetRequestModifier(modifier RequestModifierFunc)

+ func (m *HTTPClientModule) Start(ctx context.Context) error

+ func (m *HTTPClientModule) Stop(ctx context.Context) error

+ func (m *HTTPClientModule) WithTimeout(timeoutSeconds int) *http.Client

+ type HTTPDoer interface

+ Do func(req *http.Request) (*http.Response, error)

+ type RequestModifierFunc func(*http.Request) *http.Request

+ type VerboseOptions struct

+ LogBody bool

+ LogFilePath string

+ LogHeaders bool

+ LogToFile bool

+ MaxBodyLogSize int