Django使用swagger生成接口文档，swagger生成接口文档

Django使用swagger生成接口文档，swagger生成接口文档

参考博客：Django接入Swagger，生成Swagger接口文档-操作解析

Swagger是一个规范和完整的框架，用于生成、描述、调用和可视化RESTful风格的Web服务。总体目标是使客户端和文件系统源代码作为服务器以同样的速度来更新。当接口有变动时，对应的接口文档也会自动更新。

Swagger优势：

django使用swagger主要步骤：

一、 安装swagger

pip install django-rest-swagger

二、 将swagger添加到settings.py配置文件的INSTALLEDAPP中，如：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'rest_framework',
    
    'rest_framework_swagger',  # swagger自动生成接口文档
    ]

三、 在主路由中配置接口文档的路由：
在项目同名目录下的urls.py中，填写如下代码：

from django.urls import path

# 导入restframework的辅助函数get_schema_view
from rest_framework.schemas import get_schema_view

# 导入swagger的两个Render类
from rest_framework_swagger.renderers import SwaggerUIRenderer,OpenAPIRenderer

# 利用get_schema_view()方法，传入两个Render类得到一个schema view
schema_view = get_schema_view(title='API',renderer_classes=[SwaggerUIRenderer,OpenAPIRenderer])

# 配置接口文档的访问路径
urlpatterns = [
    # 访问localhost:8000/docs/即可
    path('docs/', schema_view, name="swagger接口文档")
]

四、 在接口类视图里面写上注释，可以被当成接口文档说明显示。启动服务，访问localhost:8000/docs/即可。

转载请注明出处！