pip3 install --user django>=2.0.0

pip3 install --user django-rest-swagger

INSTALLED_APPS = [

'app.apps.AppConfig',

'rest_framework',

'rest_framework_swagger',

]

SWAGGER_SETTINGS = {

# 基础样式

'SECURITY_DEFINITIONS': {

"basic":{

'type': 'basic'

}

},

'LOGIN_URL': 'rest_framework:login',

'LOGOUT_URL': 'rest_framework:logout',

# 'DOC_EXPANSION': None,

# 'SHOW_REQUEST_HEADERS':True,

# 'USE_SESSION_AUTH': True,

# 'DOC_EXPANSION': 'list',

# 接口文档中方法列表以首字母升序排列

'APIS_SORTER': 'alpha',

# 如果支持json提交, 则接口文档中包含json输入框

'JSON_EDITOR': True,

# 方法列表字母排序

'OPERATIONS_SORTER': 'alpha',

'VALIDATOR_URL': None,

}

from django.conf.urls import url,include

from django.contrib import admin

from rest_framework import routers

from app import views

router = routers.DefaultRouter()

router.register(r'users',views.UserViewSet,base_name='user')

router.register(r'groups',views.GroupViewSet,base_name='group')

from rest_framework.schemas import get_schema_view

from rest_framework_swagger.renderers import SwaggerUIRenderer, OpenAPIRenderer

schema_view = get_schema_view(title='Users API', renderer_classes=[OpenAPIRenderer, SwaggerUIRenderer])

urlpatterns = [

# swagger接口文档路由

# url(r'^docs/', schema_view, name="docs"), 注：此条docs用到上面的router

url(r'^docs/', views.SwaggerSchemaView.as_view(), name='apiDocs'), # 此条是自定义，本篇主要使用此条

url(r'^admin/', admin.site.urls),

url(r'^',include(router.urls)),

url(r'^api-auth/',include('rest_framework.urls',namespace='rest_framework')),

url(r'^api/getjson', views.ReturnJson.as_view()),

]

from django.http import HttpResponse, JsonResponse

from django.contrib.auth.models import User,Group

from rest_framework import viewsets

from app.serializer import UserSerializer,GroupSerializer

from rest_framework.response import Response

from .serializer import UserBaseSerializer

from rest_framework.permissions import AllowAny

from rest_framework.schemas import SchemaGenerator

from rest_framework.schemas.generators import LinkNode, insert_into

from rest_framework.renderers import CoreJSONRenderer

from rest_framework_swagger import renderers

from rest_framework.views import APIView

import coreapi

from django.http import QueryDict

from rest_framework.request import Request

class MySchemaGenerator(SchemaGenerator):

def get_links(self, request=None):

# from rest_framework.schemas.generators import LinkNode,

links = LinkNode()

paths = []

view_endpoints = []

for path, method, callback in self.endpoints:

view = self.create_view(callback, method, request)

path = self.coerce_path(path, method, view)

paths.append(path)

view_endpoints.append((path, method, view))

# Only generate the path prefix for paths that will be included

if not paths:

return None

prefix = self.determine_path_prefix(paths)

for path, method, view in view_endpoints:

if not self.has_view_permissions(path, method, view):

continue

link = view.schema.get_link(path, method, base_url=self.url)

# 添加下面这一行方便在views编写过程中自定义参数.

link._fields += self.get_core_fields(view)

subpath = path[len(prefix):]

keys = self.get_keys(subpath, method, view)

# from rest_framework.schemas.generators import LinkNode, insert_into

insert_into(links, keys, link)

return links

# 从类中取出我们自定义的参数, 交给swagger 以生成接口文档.

def get_core_fields(self, view):

return getattr(view, 'coreapi_fields', ())

class SwaggerSchemaView(APIView):

_ignore_model_permissions = True

exclude_from_schema = True

# from rest_framework.permissions import AllowAny

permission_classes = [AllowAny]

# from rest_framework_swagger import renderers

# from rest_framework.renderers import *

renderer_classes = [

CoreJSONRenderer,

renderers.OpenAPIRenderer,

renderers.SwaggerUIRenderer

]

def get(self, request):

generator = MySchemaGenerator(title='xxxxx',

description='''xxxxx''')

schema = generator.get_schema(request=request)

# from rest_framework.response import Response

return Response(schema)

# Create your views here.

# class UserViewSet(viewsets.ModelViewSet):

# '''查看，编辑用户的界面'''

# queryset = User.objects.all().order_by('-date_joined')

# serializer_class = UserSerializer

#

# class GroupViewSet(viewsets.ModelViewSet):

# '''查看，编辑组的界面'''

# queryset = Group

# serializer_class = GroupSerializer

def DocParam(name="default", location="query",

required=True, description=None, type="string",

*args, **kwargs):

# 页面编辑显示输入参数

return coreapi.Field(name=name, location=location,

required=required, description=description,

type=type)

def get_parameter_dic(request, *args, **kwargs):

# 处理自定义接口传过来的参数值

if isinstance(request, Request) == False:

    return {}

query_params = request.query_params

if isinstance(query_params, QueryDict):

    query_params = query_params.dict()

    result_data = request.data

if isinstance(result_data, QueryDict):

r   esult_data = result_data.dict()

if query_params != {}:

    query_params

else:

    return result_data

class ReturnJson(APIView):

    coreapi_fields = (

    DocParam("token"),

    DocParam('id'),

    )

    def get(self, request, *args, **kwargs):

        params = get_parameter_dic(request)

        print(params)

        return JsonResponse(data=params)

    def post(self, request, *args, **kwargs):

        params = get_parameter_dic(request)

        return JsonResponse(data=params)

    def put(self, request, *args, **kwargs):

        params = get_parameter_dic(request)

        return JsonResponse(data=params)