Auto-document API endpoints with Swagger

[phacks]

Falco offers a fully featured REST API, for which we need to write and update the documentation.

A few DRF-Swagger plugins are available, which would save us a lot of time in both writing and maintaining said documentation:

• https://django-rest-swagger.readthedocs.io/en/latest/
• https://drf-yasg.readthedocs.io/en/stable/index.html

What would be even cooler is to integrate the documentation right inside the Docusaurus build for the docs, however it does not look possible at the moment.