api

package
v1.2.0 Latest Latest
Warning

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

Go to latest
Published: Nov 12, 2021 License: MIT Imports: 13 Imported by: 3

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func DefaultEndpoint

func DefaultEndpoint(c echo.Context) error

DefaultEndpoint returns http.StatusOK if the service is able to respond to requests.

func ErrorResponse

func ErrorResponse(c echo.Context, status int, err error) error

ErrorResponse reports the error and responds with an ErrorObject

func LogHttpRequest added in v1.1.0

func LogHttpRequest(ctx context.Context, req *http.Request)

func ParseRange added in v1.2.0

func ParseRange(r string) (int64, int64)

ParseRange extracts a byte range if specified. For specs see https://developer.mozilla.org/en-US/docs/Web/HTTP/Range_requests

func ReceiveFileUpload added in v1.1.0

func ReceiveFileUpload(ctx context.Context, req *http.Request, location, formName string) (string, error)

ReceiveFileUpload handles the reception of uploads and puts the files into a specified location

func StandardResponse

func StandardResponse(c echo.Context, status int, res interface{}) error

StandardResponse is the default way to respond to API requests

func UnmashalJSONResponse added in v1.1.0

func UnmashalJSONResponse(resp *http.Response, v interface{}, b *[]byte) error

UnmashalJSONResponse unmarshalls a generic HTTP response body into a JSON structure Pass optionally a pointer to a byte array to get the raw body of the response object written back

Types

type RelevantHeaders added in v1.2.0

type RelevantHeaders struct {
	Range           string `header:"Range"`
	UserAgent       string `header:"User-Agent"`
	Forwarded       string `header:"Forwarded"`
	XForwardedFor   string `header:"X-Forwarded-For"`
	XForwwardedHost string `header:"X-Forwarded-Host"`
	Referer         string `header:"Referer"`
}

RelevantHeaders represents the most important headers

func ExtractHeaders added in v1.2.0

func ExtractHeaders(r *http.Request) RelevantHeaders

ExtractHeaders extracts the relevant HTTP header stuff only

func (*RelevantHeaders) Ranges added in v1.2.0

func (h *RelevantHeaders) Ranges() (int64, int64)

type StatusObject

type StatusObject struct {
	Status    int    `json:"status" binding:"required"`
	Message   string `json:"message" binding:"required"`
	RootError error  `json:"-"`
}

StatusObject is used to report operation status and errors in an API request. The struct can be used as a response object or be treated as an error object

func NewErrorStatus

func NewErrorStatus(s int, e error) StatusObject

NewErrorStatus initializes a new StatusObject from an error

func NewStatus

func NewStatus(s int, m string) StatusObject

NewStatus initializes a new StatusObject

func (*StatusObject) Error

func (so *StatusObject) Error() string

func (*StatusObject) String

func (so *StatusObject) String() string

Jump to

Keyboard shortcuts

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