Replace manual API documentation with OpenAPI

[stveit]

API documentation on https://argus-server.readthedocs.io/en/latest/api.html should ideally be defined via OpenAPI instead of manually in a .rst file. This will require a way to hook the generated documentation from OpenAPI into readthedocs

• Research how to generate API Sphinx docs from OpenAPI/Swagger #628
  • Demonstrate automatic Sphinx openapi #648
• Move the current text descriptions of API endpoints from Sphinx docs to endpoint to codebase
• Our openapi schema needs to be improved #642

[seiji-alyosha]

Hey @stveit! Do you still need help with making the API documentation fit OpenAPI specs? I can assist with converting the documentation to a SwaggerUI platform with OpenAPI specs.

[stveit]

Hey @stveit! Do you still need help with making the API documentation fit OpenAPI specs? I can assist with converting the documentation to a SwaggerUI platform with OpenAPI specs.

Thank you for offering to help @jaketanis, but we are not looking to go "full OpenAPI" with code generation and such. We are currently generating OpenAPI specs programmatically in Django via drf-spectacular, so our goals are basically to do more of that and integrate it with Sphinx to make the API docs easier to maintain.