django-rest-swagger对API接口注释的方法

Swagger是一个API开发者的工具框架，用于生成、描述、调用和可视化RESTful风格的Web服务。总体目标是使客户端和文件系统服务器以同样的速度来更新，方法，参数和模型紧密集成到服务器端的代码中，允许API始终保持同步。在使用 django-rest-framework 进行API开发，可以使用django-rest-swagger接入swagger自动生成接口文档。该博文的项目是django-rest-framework中文站点的例子：当需要对接口的各种方法进行注释时，直接在该类下添加注释，如下所示。