httpclient

Feb 4, 2026

Changes in this version

+ const ContentTypeFormURLEncoded

+ const ContentTypeJSON

+ const DefaultTimeout

+ const HeaderAuthorization

+ const HeaderContentType

+ const HeaderXRequestID

+ var ErrAuthFailed = errors.New("httpclient: authentication failed")

+ var ErrCreateRequest = errors.New("httpclient: failed to create request")

+ var ErrDecodeResponse = errors.New("httpclient: failed to decode response")

+ var ErrEncodeBody = errors.New("httpclient: failed to encode request body")

+ var ErrRequestFailed = errors.New("httpclient: request failed")

+ var ErrResponseTooLarge = errors.New("httpclient: response body too large")

+ var ErrServiceError = errors.New("httpclient: service error")

+ var ErrTokenRequestFailed = errors.New("httpclient: token request failed")

+ func DeleteJSON[T any](ctx context.Context, c *Client, path string, opts ...RequestOption) (T, error)

+ func DoJSON[T any](ctx context.Context, c *Client, method, path string, body any, ...) (T, error)

+ func GetJSON[T any](ctx context.Context, c *Client, path string, opts ...RequestOption) (T, error)

+ func PatchJSON[T any](ctx context.Context, c *Client, path string, body any, opts ...RequestOption) (T, error)

+ func PostJSON[T any](ctx context.Context, c *Client, path string, body any, opts ...RequestOption) (T, error)

+ func PutJSON[T any](ctx context.Context, c *Client, path string, body any, opts ...RequestOption) (T, error)

+ type AuthConfig struct

+ ClientID string

+ ClientSecret string

+ TokenURL string

+ type Client struct

+ func New(baseURL string, opts ...Option) *Client

+ func (c *Client) BaseURL() string

+ func (c *Client) Delete(ctx context.Context, path string, response any, opts ...RequestOption) error

+ func (c *Client) Do(ctx context.Context, method string, path string, body any, response any, ...) error

+ func (c *Client) Get(ctx context.Context, path string, response any, opts ...RequestOption) error

+ func (c *Client) Head(ctx context.Context, path string, opts ...RequestOption) (*Response, error)

+ func (c *Client) Options(ctx context.Context, path string, opts ...RequestOption) (*Response, error)

+ func (c *Client) Patch(ctx context.Context, path string, body any, response any, ...) error

+ func (c *Client) Post(ctx context.Context, path string, body any, response any, ...) error

+ func (c *Client) Put(ctx context.Context, path string, body any, response any, ...) error

+ type Doer interface

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

+ type ErrorResponse struct

+ Internal string

+ Message string

+ type Option func(*Client)

+ func WithAuth(cfg AuthConfig) Option

+ func WithDefaultHeaders(headers map[string]string) Option

+ func WithHTTPClient(httpClient *http.Client) Option

+ func WithMaxResponseSize(size int64) Option

+ func WithRequestIDKey(key any) Option

+ func WithTimeout(timeout time.Duration) Option

+ func WithTokenProvider(provider TokenProvider) Option

+ type Registry struct

+ func NewRegistry(defaultOpts ...Option) *Registry

+ func (r *Registry) Client(name string) *Client

+ func (r *Registry) Count() int

+ func (r *Registry) GetClient(name string) (*Client, bool)

+ func (r *Registry) Has(name string) bool

+ func (r *Registry) MustClient(name string) *Client

+ func (r *Registry) Names() []string

+ func (r *Registry) Register(name, baseURL string, opts ...Option) *Registry

+ func (r *Registry) Unregister(name string) bool

+ type RequestOption func(*requestConfig)

+ func WithQuery(key, value string) RequestOption

+ func WithQueryParams(params map[string]string) RequestOption

+ func WithRequestHeader(key, value string) RequestOption

+ func WithRequestID(requestID string) RequestOption

+ func WithRequestTimeout(timeout time.Duration) RequestOption

+ type Response struct

+ Headers map[string]string

+ RequestID string

+ StatusCode int

+ type ServiceError struct

+ Internal string

+ Message string

+ RequestID string

+ StatusCode int

+ func IsServiceError(err error) (*ServiceError, bool)

+ func NewServiceError(statusCode int, message, internal, requestID string) *ServiceError

+ func (e *ServiceError) Error() string

+ func (e *ServiceError) Is(target error) bool

+ func (e *ServiceError) Unwrap() error

+ type TokenProvider interface

+ GetToken func(ctx context.Context) (string, error)

+ InvalidateToken func()