OpenAPI/Swagger reference for the REST api

[olix3001]

Create REST api reference for use by frontend developers.

This includes testing auto-generated docs via https://github.com/ad-on-is/adonis-autoswagger project
or creating spec manually in case it does not produce usable results