Create API documentation

This API should have a proper documentation available.

Document:

• What the API is about
• How to acquire authentication credentials
• Resources required to use the API
• Error messages when interacting with the API
• All requests, expected arguments, usage,...

Could be done automatically with Postman / Swagger ?