如何使用drf_yasg - Django对swagger API端点(基于函数的视图)进行分组

pip install drf_yasg

INSTALLED_APPS = [
    ...
    'drf_yasg',
    ...
]

from django.conf.urls import url
from django.urls import include
from rest_framework import permissions
from drf_yasg.views import get_schema_view
from drf_yasg import openapi

schema_view = get_schema_view(
    openapi.Info(
        title="API文档",
        default_version='v1',
        description="API接口文档",
        terms_of_service="https://www.example.com/policies/terms/",
        contact=openapi.Contact(email="contact@example.com"),
        license=openapi.License(name="BSD License"),
    ),
    public=True,
    permission_classes=(permissions.AllowAny,),
)

urlpatterns = [
    ...
    url(r'^swagger(?P<format>\.json|\.yaml)$', schema_view.without_ui(cache_timeout=0), name='schema-json'),
    url(r'^swagger/$', schema_view.with_ui('swagger', cache_timeout=0), name='schema-swagger-ui'),
    url(r'^redoc/$', schema_view.with_ui('redoc', cache_timeout=0), name='schema-redoc'),
    ...
]

from drf_yasg import openapi
from drf_yasg.utils import swagger_auto_schema
from rest_framework.decorators import api_view
from rest_framework.response import Response

@swagger_auto_schema(tags=['用户管理'])
@api_view(['GET'])
def user_list(request):
    """
    用户列表
    """
    # 处理用户列表逻辑
    return Response(...)

@swagger_auto_schema(tags=['用户管理'])
@api_view(['POST'])
def create_user(request):
    """
    创建用户
    """
    # 处理创建用户逻辑
    return Response(...)