python - Django 休息框架 : How to enable swagger docs for function based views

Question

我通过了Django REST Swagger 2.1.2 documentation .当我尝试使用基于类的 View 时，它运行良好。

但我没有找到任何关于如何为基于函数的 View 启用 swagger 的引用，如下所示:

@api_view(['GET', 'POST'])
def app_info(request): 
    ...
    return response

我的大部分 views.py 都充满了基于函数的 View ，就像上面一样。

任何有关如何启用相同功能的帮助将不胜感激。谢谢!

我正在使用 Django:1.8； Django REST Swagger:2.1.2； DRF:3.6.2

Answer 1

您应该可以使用 @renderer_classes装饰师:

from rest_framework_swagger import renderers
from rest_framework.decorators import api_view, renderer_classes


@api_view(['GET', 'POST'])
@renderer_classes([renderers.OpenAPIRenderer, renderers.SwaggerUIRenderer])
def app_info(request): 
    ...
    return response

另外，值得一提的是，如果你不想在每个 View 上都使用这个装饰器，你可以指定 DEFAULT_RENDERER_CLASSES in settings

编辑:它似乎毕竟在文档中。查看此页面的最底部:https://django-rest-swagger.readthedocs.io/en/latest/schema/