API request and response

[marcotroisi]

Define the API request and response in JSON format for this microservice.

A starting point can be the document we already have on the usermanager: https://github.com/microlib/usermanager/blob/master/README.md

The standard we're using is JsonAPI.