如何使用django_rest_swagger 2.1.1显示接口描述

Question

对于0.3版本，DRF能够读取Swagger设置中的信息数据，并在Swagger UI中呈现它。

SWAGGER_SETTINGS = 
{  
......  
"info": {  
    'contact': 'xxxxx@github.com',   
    'description': 'This document intends to describe all Restful APIs.',  
    'title': 'GSLB API document',  
     },  
"USE_SESSION_AUTH": True  
}

但是对于2.1.1版，似乎在swagger_settings中不支持info字段？标题可以按如下方式传递：

schema_view = get_swagger_view(title='My Restful API')

但是似乎没有办法将描述传递给get_swagger_view，因此我无法在Swagger UI上显示描述。在这个版本中有解决方法吗？谢谢。

Answer 1

对于当前版本的Django Rest框架Swagger，添加文档字符串注释似乎是可行的(例如，它们在Swagger文档中显示为描述)。

class MyExport(mixins.ListModelMixin, viewsets.GenericViewSet): """ A really cool function"""

“一个非常酷的功能”显示为swagger视图中的描述。