restlib

type APIClient interface {
	// MessageType retrieves the type of messages sent and received over the API
	MessageType() MessageType

	// Host retrieves the API host server
	Host() *url.URL

	// Call will send the message to the API host, and expect a response message in return
	Call(path string, request *Message, response *Message) (err error)
}

type Message struct {
	// Method tells which method to use when sending request
	Method string

	// Status is a representation of eg. http status code in responses
	Status int

	// Header is a map of Message headers
	Header http.Header

	// Body is the message body object
	// the message body is de-serialized at retrieval and serialized before sending request
	Body interface{}
}

type MessageType interface {
	// ContentType retrieves the MIME-type of the message body
	ContentType() string

	// Serializer retrieves the message serializer to use
	Serializer() Serializer
}

type Serializer interface {
	// Marshal will convert the message in to a byte slice for sending in request
	Marshal(*Message) ([]byte, error)

	// Unmarshal will convert a raw message into the provided pointer to a Message interfaced struct
	Unmarshal([]byte, *Message) error
}