restful

Feb 17, 2026

Changes in this version

type Router

+ func (r *Router) MethodNotAllowedHandler(handler http.Handler) *Router

Dec 29, 2025

Changes in this version

type Server

+ func (s *Server) TLSConfig() *tls.Config

Dec 3, 2025

Changes in this version

+ type TLSOwnCertOpts struct

+ Certificate string

+ PrivateKey string

Oct 21, 2025

Changes in this version

type Client

+ func (c *Client) GetTransport() http.RoundTripper

+ func (c *Client) SetTransport(transport http.RoundTripper)

Oct 20, 2025

Changes in this version

+ type LocalIPs struct

+ IPv4 *net.TCPAddr

+ IPv6 *net.TCPAddr

+ func GetIPFromInterface(networkInterface string) (theIPs LocalIPs)

Sep 25, 2025

Changes in this version

+ var ErrCertificateRevoked = errors.New("certificate revoked")

+ var ErrRevocationListOutOfDate = errors.New("revocation list out of date")

+ var ErrRevocationListReadError = errors.New("error reading revocation list")

type CRLOptions

+ StatusChan chan (error)

Sep 9, 2025

Changes in this version

+ type CRLOptions struct

+ CRLLocation string

+ Ctx context.Context

+ ErrChan chan (error)

+ FileExistTimeout time.Duration

+ ReadInterval time.Duration

+ StrictValityCheck bool

type Client

+ func (c *Client) CRL(o CRLOptions) *Client

type Server

+ func (s *Server) CRL(o CRLOptions) *Server

Jun 26, 2025

Changes in this version

type Client

+ LoadBalanceRandom bool

+ func (c *Client) EnableLoadBalanceRandom() *Client

Jun 6, 2025

Changes in this version

+ var ReadErrConverter func(err error) error

Apr 4, 2025

Changes in this version

+ const ErrorBodyMaxLen

+ var DialTimeout = 2 * time.Second

+ var ValidateErrConverter func(err error) error

Mar 28, 2025

Changes in this version

+ var Validate *validator.Validate = validator.New(validator.WithRequiredStructEnabled())

Mar 12, 2025

Changes in this version

+ var DisallowUnknownFields = false

type Router

+ func (r *Router) DisallowUnknownFields() *Router

Feb 20, 2025

Changes in this version

+ var LambdaValidationErrorStatus = http.StatusUnprocessableEntity

type Client

+ func (c *Client) PostFormWithFullResponse(ctx context.Context, target string, reqData url.Values, cookies []*http.Cookie, ...) (*http.Response, error)

Dec 11, 2024

Changes in this version

type Client

+ func NewH2CClientWInterface(networkInterface string) *Client

+ func NewH2ClientWInterface(networkInterface string) *Client

Sep 25, 2024

Changes in this version

+ func NewErrorWithBody(err error, statusCode int, contentType string, body []byte) error

Sep 4, 2024

Changes in this version

+ var LambdaValidator = true

May 7, 2024

Changes in this version

+ var DefaultTokenClient *http.Client = &http.Client

type Client

+ func (c *Client) SetOauth2H2() *Client

May 3, 2024

Changes in this version

+ func AddLambdaToContext(ctx context.Context, l *lambda.Lambda) context.Context

type Client

+ func NewClientWInterface(networkInterface string) *Client

Apr 5, 2024

Changes in this version

+ const ContentTypeMsgPack

type Client

+ func (c *Client) MsgPack(allowed bool) *Client

Feb 7, 2024

Changes in this version

type Client

+ func (c *Client) SetOauth2Conf(config oauth2.Config, grant ...Grant) *Client

+ type Grant string

+ const GrantClientCredentials

+ const GrantPasswordCredentials

+ const GrantRefreshToken

Feb 1, 2024

Changes in this version

+ var ErrUnexpectedContentType = errors.New("unexpected Content-Type")

+ func GetErrBody(err error) (string, []byte)

Jan 24, 2024

Changes in this version

+ var ErrNonHTTPSURL = errors.New("non-https URL not allowed")

type Client

+ func (c *Client) HTTPS(config *HTTPSConfig) *Client

+ type HTTPSConfig struct

+ AllowHTTP bool

+ AllowLocalhostHTTP bool

+ AllowedHTTPHosts []string

Dec 12, 2023

Changes in this version

+ func SetOTelGrpc(target string) error

Jun 5, 2023

Changes in this version

+ func SetOTel(enabled bool, tp *sdktrace.TracerProvider)

Mar 1, 2023

Changes in this version

+ func SetServerName(s string)

May 5, 2023

Changes in this version

+ func SetTrace(b bool)

type Lambda

+ func (l *Lambda) TraceID() string

Aug 25, 2022

Changes in this version

+ var TokenClient *http.Client = &http.Client

type Client

+ func (c *Client) SetClientCredentialAuth(clientID, clientSecret, tokenURL string) *Client

Jul 15, 2022

Changes in this version

+ const KindBasic

+ const KindH2

+ const KindH2C

type Client

+ Client *http.Client

+ Kind string

Jul 14, 2022

Changes in this version

+ var ServerReadHeaderTimeout = 5 * time.Second

+ var ServerReadTimeout = 60 * time.Second

type Client

+ func (c *Client) Monitor(pre ClientMonitorFuncPre, post ClientMonitorFuncPost) *Client

+ type ClientMonitorFuncPost func(req *http.Request, resp *http.Response, err error) *http.Response

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

Jan 17, 2022

Changes in this version

+ type InvalidParam struct

+ Param string

+ Reason string

Jan 13, 2022

Changes in this version

type ProblemDetails

+ Cause string

Nov 12, 2021

Changes in this version

type Client

+ func (c *Client) CheckRedirect(checkRedirect func(req *http.Request, via []*http.Request) error) *Client

Oct 7, 2021

Changes in this version

type Client

+ func (c *Client) Jar() http.CookieJar

+ func (c *Client) SetJar(jar http.CookieJar) *Client

Oct 7, 2021

Changes in this version

type Client

+ func (c *Client) SetBasicAuth(username, password string) *Client

type Lambda

+ func (l *Lambda) RequestBasicAuth() (username, password string, ok bool)

Sep 20, 2021

Changes in this version

type Server

+ func (s *Server) Restart()

Aug 6, 2021

Changes in this version

type Client

+ func (c *Client) AcceptProblemJSON(acceptProblemJSON bool) *Client

Jul 7, 2021

Changes in this version

type Lambda

+ func (l *Lambda) RequestVars() map[string]string

+ func (l *Lambda) ResponseStatus(status int)

type Route

+ func (route *Route) Queries(pairs ...string) *Route

type Router

+ func (r *Router) Queries(pairs ...string) *Route

Jul 2, 2021

Changes in this version

type Client

+ func (c *Client) Timeout(timeout time.Duration) *Client

Jun 16, 2021

Changes in this version

+ func NewDetailedError(err error, status int, pd ProblemDetails) error

+ func SendProblemDetails(w http.ResponseWriter, r *http.Request, err error) error

+ type ProblemDetails struct

+ Detail string

+ Instance string

+ InvalidParams map[string]string

+ Status int

+ Title string

+ Type string

+ func (e ProblemDetails) String() string

May 17, 2021

Changes in this version

+ const AcceptHeader

+ const ContentTypeAny

+ const ContentTypeApplicationAny

+ const ContentTypeApplicationJSON

+ const ContentTypeForm

+ const ContentTypeHeader

+ const ContentTypeMergeJSON

+ const ContentTypeMultipartForm

+ const ContentTypePatchJSON

+ const ContentTypeProblemJSON

+ var AddrHTTP = ":8080"

+ var AddrHTTPS = ":8443"

+ var ClientCAs string = "/etc/clientcas"

+ var DefaultServeMux = NewRouter()

+ var HealthCheckPath = "/healthz"

+ var LambdaMaxBytesToParse = 0

+ var LambdaSanitizeJSON = false

+ var LivenessProbePath = "/livez"

+ var OwnTLSCert string = "/etc/own-tls/tls.crt"

+ var OwnTLSKey string = "/etc/own-tls/tls.key"

+ var ReadinessProbePath = "/readyz"

+ func BaseContentType(contentType string) string

+ func Delete(ctx context.Context, target string) error

+ func DetailError(err error, description string) error

+ func Get(ctx context.Context, target string, respData interface{}) error

+ func GetBaseContentType(headers http.Header) string

+ func GetDataBytes(headers http.Header, ioBody io.ReadCloser, maxBytes int) (body []byte, err error)

+ func GetDataBytesForContentType(headers http.Header, ioBody io.ReadCloser, maxBytes int, ...) (body []byte, err error)

+ func GetErrStatusCode(err error) int

+ func GetErrStatusCodeElse(err error, elseStatusCode int) int

+ func GetRequestData(req *http.Request, maxBytes int, data interface{}) error

+ func GetResponseData(resp *http.Response, maxBytes int, data interface{}) error

+ func IsConnectError(err error) bool

+ func LambdaWrap(f interface{}) http.HandlerFunc

+ func ListenAndServe(addr string, handler http.Handler) error

+ func ListenAndServeMTLS(addr, certFile, keyFile, clientCerts string, handler http.Handler) error

+ func ListenAndServeTLS(addr, certFile, keyFile string, handler http.Handler) error

+ func Logger(h http.Handler) http.Handler

+ func Monitor(h http.Handler, pre MonitorFuncPre, post MonitorFuncPost) http.Handler

+ func NewCertPool(path string) *x509.CertPool

+ func NewError(err error, statusCode int, description ...string) error

+ func NewRequestCtx(w http.ResponseWriter, r *http.Request) context.Context

+ func NewTestCtx(method string, rawurl string, header http.Header, vars map[string]string) context.Context

+ func Patch(ctx context.Context, target string, reqData, respData interface{}) error

+ func PingList(ctx context.Context, targets []string) error

+ func Post(ctx context.Context, target string, reqData, respData interface{}) (*url.URL, error)

+ func Put(ctx context.Context, target string, reqData, respData interface{}) (*url.URL, error)

+ func SanitizeJSONBytes(b []byte) []byte

+ func SanitizeJSONString(s string) string

+ func SendEmptyResponse(w http.ResponseWriter, statusCode int)

+ func SendJSONResponse(w http.ResponseWriter, statusCode int, data interface{}, sanitizeJSON bool) (err error)

+ func SendLocationResponse(w http.ResponseWriter, location string)

+ func SendProblemResponse(w http.ResponseWriter, r *http.Request, statusCode int, problem string) (err error)

+ func SendResp(w http.ResponseWriter, r *http.Request, err error, data interface{}) error

+ func SendResponse(w http.ResponseWriter, statusCode int, data interface{}) error

+ func SetFormatter(formatter logrus.Formatter)

+ func Start() error

+ func StartTLS(cleartext, mutualTLS bool) error

+ type Client struct

+ func NewClient() *Client

+ func NewH2CClient() *Client

+ func NewH2Client() *Client

+ func (c *Client) BroadcastRequest(ctx context.Context, method string, target string, headers http.Header, ...) error

+ func (c *Client) Delete(ctx context.Context, target string) error

+ func (c *Client) Do(ctx context.Context, req *http.Request) (*http.Response, error)

+ func (c *Client) Get(ctx context.Context, target string, respData interface{}) error

+ func (c *Client) Head(ctx context.Context, target string) (map[string][]string, error)

+ func (c *Client) Insecure() *Client

+ func (c *Client) Patch(ctx context.Context, target string, reqData, respData interface{}) error

+ func (c *Client) PingList(ctx context.Context, targets []string) error

+ func (c *Client) Post(ctx context.Context, target string, reqData, respData interface{}) (*url.URL, error)

+ func (c *Client) PostForm(ctx context.Context, target string, reqData url.Values, respData interface{}) (*url.URL, error)

+ func (c *Client) Put(ctx context.Context, target string, reqData, respData interface{}) (*url.URL, error)

+ func (c *Client) Retry(retries int, backoffInit time.Duration, backoffMax time.Duration) *Client

+ func (c *Client) Root(rootURL string) *Client

+ func (c *Client) SanitizeJSON() *Client

+ func (c *Client) SendRecv(ctx context.Context, method string, target string, headers http.Header, ...) (*http.Response, error)

+ func (c *Client) SendRecv2xx(ctx context.Context, method string, target string, headers http.Header, ...) (*http.Response, error)

+ func (c *Client) SendRecvListFirst2xxParallel(ctx context.Context, method string, targets []string, headers http.Header, ...) (*http.Response, error)

+ func (c *Client) SendRecvListFirst2xxSequential(ctx context.Context, method string, targets []string, headers http.Header, ...) (*http.Response, error)

+ func (c *Client) SendRecvResolveFirst2xxParallel(ctx context.Context, method string, target string, headers http.Header, ...) (*http.Response, error)

+ func (c *Client) SendRecvResolveFirst2xxSequential(ctx context.Context, method string, target string, headers http.Header, ...) (*http.Response, error)

+ func (c *Client) SendRequest(ctx context.Context, method string, target string, headers http.Header, ...) (*http.Response, error)

+ func (c *Client) SetMaxBytesToParse(max int) *Client

+ func (c *Client) TLS(tlsConfig *tls.Config) *Client

+ func (c *Client) TLSOwnCerts(dir string) *Client

+ func (c *Client) TLSRootCerts(path string) *Client

+ func (c *Client) UserAgent(userAgent string) *Client

+ type Lambda struct

+ func L(ctx context.Context) *Lambda

+ func (l *Lambda) RequestHeader() http.Header

+ func (l *Lambda) RequestHeaderGet(header string) string

+ func (l *Lambda) RequestHeaderValues(header string) []string

+ func (l *Lambda) RequestMethod() string

+ func (l *Lambda) RequestPathParameters() map[string]string

+ func (l *Lambda) RequestQueryStringParameter(parameter string) string

+ func (l *Lambda) RequestURL() *url.URL

+ func (l *Lambda) ResponseHeader() http.Header

+ func (l *Lambda) ResponseHeaderAdd(header, value string)

+ func (l *Lambda) ResponseHeaderAddAs(header, value string)

+ func (l *Lambda) ResponseHeaderSet(header, value string)

+ type MonitorFuncPost func(w http.ResponseWriter, r *http.Request, statusCode int)

+ type MonitorFuncPre func(w http.ResponseWriter, r *http.Request) *http.Request

+ type Route mux.Route

+ func HandleFunc(path string, f interface{}) *Route

+ func (route *Route) GetError() error

+ func (route *Route) Handler(handler http.Handler) *Route

+ func (route *Route) HandlerFunc(f interface{}) *Route

+ func (route *Route) Methods(methods ...string) *Route

+ func (route *Route) Name(name string) *Route

+ func (route *Route) Path(pathTemplate string) *Route

+ func (route *Route) PathPrefix(pathTemplate string) *Route

+ func (route *Route) Schemes(schemes ...string) *Route

+ func (route *Route) Subrouter() *Router

+ type Router struct

+ func NewRouter() *Router

+ func (r *Router) Get(name string) *Route

+ func (r *Router) Handle(path string, handler http.Handler) *Route

+ func (r *Router) HandleFunc(path string, f interface{}) *Route

+ func (r *Router) Host(hostRegex string) *Route

+ func (r *Router) ListenAndServe(addr string) error

+ func (r *Router) ListenAndServeMTLS(addr, certFile, keyFile, clientCerts string) error

+ func (r *Router) ListenAndServeTLS(addr, certFile, keyFile string) error

+ func (r *Router) Methods(methods ...string) *Route

+ func (r *Router) Monitor(pre MonitorFuncPre, post MonitorFuncPost) *Router

+ func (r *Router) Name(name string) *Route

+ func (r *Router) Path(pathTemplate string) *Route

+ func (r *Router) PathPrefix(pathTemplate string) *Route

+ func (r *Router) Schemes(schemes ...string) *Route

+ func (r *Router) ServeHTTP(w http.ResponseWriter, req *http.Request)

+ func (r *Router) Start() error

+ func (r *Router) StartTLS(cleartext, mutualTLS bool) error

+ type Server struct

+ func NewServer() *Server

+ func (s *Server) Addr(addr string) *Server

+ func (s *Server) Close() error

+ func (s *Server) Graceful(gracePeriod time.Duration) *Server

+ func (s *Server) Handler(handler http.Handler) *Server

+ func (s *Server) ListenAndServe() error

+ func (s *Server) Monitor(pre MonitorFuncPre, post MonitorFuncPost) *Server

+ func (s *Server) Shutdown(ctx context.Context) error

+ func (s *Server) TLSClientCert(path string) *Server

+ func (s *Server) TLSServerCert(certFile, keyFile string) *Server