Documenting REST API with Flask-Restx

This tutorial aims to use the Flask-restx library to implement and to document the REST API. Other similar libraries in the Flask framework include the flask_resful and  Flask-restplus libraries. 

The generated document is shown below.  All the operations are group into a default namespace. All the CRUD operations get, create, and update (except for the the delete operation) are displayed  below. 

References

- https://flask-restx.readthedocs.io/en/latest/

- https://preslav.me/2018/12/02/designing-well-structured-rest-apis-with-flask-restplus-part-1/

- https://www.freecodecamp.org/news/structuring-a-flask-restplus-web-service-for-production-builds-c2ec676de563/

- https://github.com/cosmic-byte/flask-restplus-boilerplate