Add documentation for API endpoints

[tomaspalma]

We should have a swagger file with the endpoints, explaining the possible request and response examples.

In the current state we need to look at the code of the backend in order to understand what the endpoints do which is not desirable at all.

We can create an Open API specification file (example here) and then host it on our backend like the example here