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

request

package

Go to main page

Versions in this module

v0

v0.3.0

Jun 8, 2026

v0.2.9

May 12, 2026

Changes in this version

type RequestBuilder

+ NoRetry bool

+ func (ar *RequestBuilder) WithNoRetry(noRetry bool) *RequestBuilder

type RequestOption

+ func WithNoRetry(noRetry bool) RequestOption

v0.2.8

May 11, 2026

v0.2.7

May 5, 2026

v0.2.6

Apr 27, 2026

v0.2.5

Apr 27, 2026

v0.2.4

Apr 24, 2026

Changes in this version

+ type AuthMode string

+ const AuthModeBasic

+ const AuthModeBearer

type AuthTransport

+ Mode AuthMode

type Request

+ Auth *AuthTransport

type Requester

+ func NewBasicAuthRequestor(logger *logs.Gen3Logger, cred *conf.Credential, conf conf.ManagerInterface, ...) Requester

+ func NewBearerTokenRequestor(logger *logs.Gen3Logger, cred *conf.Credential, conf conf.ManagerInterface, ...) Requester

v0.2.3

Apr 21, 2026

Changes in this version

+ type AuthTransport struct

+ Base http.RoundTripper

+ Cred *conf.Credential

+ Manager conf.ManagerInterface

+ func (t *AuthTransport) NewAccessToken(ctx context.Context) error

+ func (t *AuthTransport) RoundTrip(req *http.Request) (*http.Response, error)

+ type Request struct

+ BaseURL string

+ Logs *logs.Gen3Logger

+ Pass string

+ RetryClient *retryablehttp.Client

+ Token string

+ User string

+ UserAgent string

+ func (r *Request) Do(ctx context.Context, method, path string, body, out any, opts ...RequestOption) error

+ type RequestBuilder struct

+ Body io.Reader

+ Headers map[string]string

+ Method string

+ PartSize int64

+ SkipAuth bool

+ Timeout time.Duration

+ Token string

+ Url string

+ func (ar *RequestBuilder) WithBody(body io.Reader) *RequestBuilder

+ func (ar *RequestBuilder) WithHeader(key, value string) *RequestBuilder

+ func (ar *RequestBuilder) WithJSONBody(v any) (*RequestBuilder, error)

+ func (ar *RequestBuilder) WithPartSize(size int64) *RequestBuilder

+ func (ar *RequestBuilder) WithQuery(key, value string) *RequestBuilder

+ func (ar *RequestBuilder) WithQueryValues(v url.Values) *RequestBuilder

+ func (ar *RequestBuilder) WithSkipAuth(skip bool) *RequestBuilder

+ func (ar *RequestBuilder) WithTimeout(d time.Duration) *RequestBuilder

+ func (ar *RequestBuilder) WithToken(token string) *RequestBuilder

+ type RequestOption func(*RequestBuilder)

+ func WithHeader(key, value string) RequestOption

+ func WithPartSize(size int64) RequestOption

+ func WithQuery(key, value string) RequestOption

+ func WithQueryValues(v url.Values) RequestOption

+ func WithSkipAuth(skip bool) RequestOption

+ func WithTimeout(d time.Duration) RequestOption

+ func WithToken(token string) RequestOption

+ type Requester interface

+ Do func(ctx context.Context, method, path string, body, out any, opts ...RequestOption) error

+ func NewRequestor(logger *logs.Gen3Logger, cred *conf.Credential, conf conf.ManagerInterface, ...) Requester

+ type ResponseError struct

+ Body string

+ Headers http.Header

+ Method string

+ Status int

+ URL string

+ func (e *ResponseError) Error() string