The consumer of this API will be able to:
- Retrieve the auth token for the user in order to be able to perform the requests with OAuth2
- In the entry point, the consumer will find the operations needed for login the user.
- When the consumer logs out, that auth token will no longer work (or will act as guest???)
The API should support at least Plain JSON, JSON-LD and HAL as output formats.
The consumer developer should be able to control which linked resources are embedded so that they can be retrieved along with a structured content in a single request.
The consumer developer can specify which fields are desired, to reduce the data transfer when the API is used from a consumer sensitive to it.