Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  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 module

Go to main page

Versions in this module

v0

v0.0.7

Dec 5, 2023

Changes in this version

+ var IsErrEmptyJSON = func(err error) bool

v0.0.5

Nov 13, 2023

Changes in this version

+ var NoOption = func(c *Client)

type Client

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

v0.0.4

Apr 15, 2023

Changes in this version

type RequestOption

+ func ClientTrace(clientTrace *httptrace.ClientTrace) RequestOption

v0.0.3

Dec 11, 2022

Changes in this version

+ func DrainResponseBody(resp *http.Response) error

v0.0.1

Oct 9, 2022

Changes in this version

+ func BindResponse(resp *http.Response, dest interface{}) (err error)

+ func DecodeError(err error, destPtr interface{}) error

+ func GetErrorCode(err error) int

+ func RegisterRequestHandler(reqHandlers ...RequestHandler)

+ type APIError struct

+ Body json.RawMessage

+ Response *http.Response

+ func ExtractError(resp *http.Response) APIError

+ func GetError(err error) (APIError, bool)

+ func (e APIError) Error() string

+ type Client struct

+ BaseURL string

+ HTTPClient *http.Client

+ PersistentRequestOptions []RequestOption

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

+ func (c *Client) Do(ctx context.Context, method, urlpath string, payload interface{}, ...) (*http.Response, error)

+ func (c *Client) DrainResponseBody(resp *http.Response)

+ func (c *Client) Form(ctx context.Context, method, urlpath string, formValues url.Values, ...) (*http.Response, error)

+ func (c *Client) GetPlainUnquote(ctx context.Context, method, urlpath string, payload interface{}, ...) (string, error)

+ func (c *Client) JSON(ctx context.Context, method, urlpath string, payload interface{}, ...) (*http.Response, error)

+ func (c *Client) NewUploader() *Uploader

+ func (c *Client) ReadJSON(ctx context.Context, dest interface{}, method, urlpath string, ...) error

+ func (c *Client) ReadPlain(ctx context.Context, dest interface{}, method, urlpath string, ...) error

+ func (c *Client) RegisterRequestHandler(reqHandlers ...RequestHandler)

+ func (c *Client) WriteTo(ctx context.Context, dest io.Writer, method, urlpath string, ...) (int64, error)

+ type DebugLogger interface

+ Debugf func(string, ...interface{})

+ type Option = func(*Client)

+ func BaseURL(uri string) Option

+ func Debug(logger DebugLogger) Option

+ func Handler(h http.Handler) Option

+ func PersistentRequestOptions(reqOpts ...RequestOption) Option

+ func RateLimit(requestsPerSecond int) Option

+ func Timeout(d time.Duration) Option

+ type RequestHandler interface

+ BeginRequest func(context.Context, *http.Request) error

+ EndRequest func(context.Context, *http.Response, error) error

+ type RequestOption = func(*http.Request) error

+ func RequestAuthorization(value string) RequestOption

+ func RequestAuthorizationBearer(accessToken string) RequestOption

+ func RequestHeader(overridePrev bool, key string, values ...string) RequestOption

+ func RequestParam(key string, values ...string) RequestOption

+ func RequestQuery(query url.Values) RequestOption

+ type Uploader struct

+ Writer *multipart.Writer

+ func (u *Uploader) AddField(key, value string) error

+ func (u *Uploader) AddFile(key, filename string) error

+ func (u *Uploader) AddFileSource(key, filename string, source io.Reader) error

+ func (u *Uploader) Upload(ctx context.Context, method, urlpath string, opts ...RequestOption) (*http.Response, error)