common

Documentation

Index

• type BadRequest
• type Client
  • func MakeClient(address string, apiHeader, apiToken string) (c *Client, err error)
  • func MakeClientWithHeaders(address string, apiHeader, apiToken string, headers []*Header) (c *Client, err error)
  • func (client *Client) Get(ctx context.Context, response interface{}, path string, request interface{}, ...) error
  • func (client *Client) GetRawMsgpack(ctx context.Context, response interface{}, path string, request interface{}, ...) error
  • func (client *Client) Post(ctx context.Context, response interface{}, path string, request interface{}, ...) error
• type Header
• type InternalError
• type InvalidToken
• type NotFound

Types

type BadRequest

type BadRequest error

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client manages the REST interface for a calling user.

func MakeClient

func MakeClient(address string, apiHeader, apiToken string) (c *Client, err error)

MakeClient is the factory for constructing a Client for a given endpoint.

func MakeClientWithHeaders

func MakeClientWithHeaders(address string, apiHeader, apiToken string, headers []*Header) (c *Client, err error)

MakeClientWithHeaders is the factory for constructing a Client for a given endpoint with additional user defined headers.

func (*Client) Get

func (client *Client) Get(ctx context.Context, response interface{}, path string, request interface{}, headers []*Header) error

get performs a GET request to the specific path against the server

func (*Client) GetRawMsgpack

func (client *Client) GetRawMsgpack(ctx context.Context, response interface{}, path string, request interface{}, headers []*Header) error

func (*Client) Post

func (client *Client) Post(ctx context.Context, response interface{}, path string, request interface{}, headers []*Header) error

post sends a POST request to the given path with the given request object. No query parameters will be sent if request is nil. response must be a pointer to an object as post writes the response there.

type Header

type Header struct {
	Key   string
	Value string
}

Header is a struct for custom headers.

type InternalError

type InternalError error

type InvalidToken

type InvalidToken error

type NotFound

type NotFound error