Add Swagger UI integration

What does this MR do and why?

Integrate Swagger UI inside the application to make API usage easier for the user.

Also add a full OpenAPI definition

Screenshots or screen recordings

MR acceptance checklist

• My code follows the style guidelines of this project
• I ran pylint and other linters for modified files
• I have performed a self-review of my own code and tested it
• I have commented my code, particularly in hard-to-understand areas
• My changes generate no new warnings
• My code needed automated testing. I have added them (this is optional task)
• I have added user readable comment in the CHANGELOG