Expose collection metadata API documentation with Swagger

[Ndpnt]

No description provided.

[MattiSG]

I get a blank page if I navigate to http://localhost:3000/api/v1/docs/ after having run npm install and npm start:api.

[MattiSG]

(also, the server does not echo the URL, which would be useful, but that's out of scope I guess)

[Ndpnt]

I get a blank page if I navigate to http://localhost:3000/api/v1/docs/ after having run npm install and npm start:api.

Hum weird 🤔. I have the same error as you with Safari but it works with Chrome and Firefox.

[Ndpnt]

Ok, I found why. It's related to the way browsers handle upgrade-insecure-requests directive.
See helmetjs/helmet#429 (comment):

Chrome and Firefox don't think that localhost needs "upgrading" from HTTP to HTTPS, but Safari does.

[Ndpnt]

I fix the issue on Safari and I also change the Swagger UI url to / instead of /docs to load the Swagger UI docs by default.

[Ndpnt]

I tried the deployment on the experimentation server, you can check the Swagger UI here: http://54.37.5.206/api/v1/

[MattiSG]

Tested locally:

• SwaggerUI or OpenAPI based on content type
• SwaggerUI demo
• Content load
• /services
• /service/Facebook

Everything works perfect!
I'm requesting changes only because of the changelog.

[MattiSG]

🎉 Perfect!!