Help us shape the future of Go! Take the 2026 Go Developer Survey

httpc

package
v1.10.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 31, 2026 License: MIT Imports: 22 Imported by: 31

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	// ErrGetWithBody indicates that GET request with body.
	ErrGetWithBody = errors.New("HTTP GET should not have body")
	// ErrHeadWithBody indicates that HEAD request with body.
	ErrHeadWithBody = errors.New("HTTP HEAD should not have body")
)

Functions

func Do added in v1.3.3

func Do(ctx context.Context, method, url string, data any) (*http.Response, error)

Do sends an HTTP request with the given arguments and returns an HTTP response. data is automatically marshal into a *httpRequest, typically it's defined in an API file.

func DoRequest

func DoRequest(r *http.Request) (*http.Response, error)

DoRequest sends an HTTP request and returns an HTTP response.

func Parse

func Parse(resp *http.Response, val any) error

Parse parses the response.

func ParseHeaders

func ParseHeaders(resp *http.Response, val any) error

ParseHeaders parses the response headers.

func ParseJsonBody

func ParseJsonBody(resp *http.Response, val any) error

ParseJsonBody parses the response body, which should be in json content type.

Types

type Option

type Option func(r *http.Request) *http.Request

Option is used to customize the *http.Client.

type Service

type Service interface {
	// Do sends an HTTP request with the given arguments and returns an HTTP response.
	Do(ctx context.Context, method, url string, data any) (*http.Response, error)
	// DoRequest sends a HTTP request to the service.
	DoRequest(r *http.Request) (*http.Response, error)
}

Service represents a remote HTTP service.

func NewService

func NewService(name string, opts ...Option) Service

NewService returns a remote service with the given name. opts are used to customize the *http.Client.

func NewServiceWithClient

func NewServiceWithClient(name string, cli *http.Client, opts ...Option) Service

NewServiceWithClient returns a remote service with the given name. opts are used to customize the *http.Client.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL