当前位置： 移动技术网 > IT编程>脚本编程>Python > Django使用swagger生成接口文档

Django使用swagger生成接口文档

2019年11月08日  | 移动技术网IT编程  | 我要评论

600156,萝卜泡菜国语,梦幻西游伏魔录1.1

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

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

swagger优势：

  1. swagger可生成一个具有互动性的api控制台，开发者可快速学习和尝试api；
  2. swagger可生成客户端sdk代码，用于不同平台上（java、python...）的实现；
  3. swagger文件可在许多不同的平台上从代码注释中自动生成；
  4. swagger有一个强大的社区，里面有许多强悍的贡献者。

django使用swagger主要步骤：

  1. 安装swagger；
  2. 添加到swagger到配置文件；
  3. 在主路由中配置路由；
  4. 启动服务，测试效果；

一、 安装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/即可。

转载请注明出处！

您可能感兴趣的文章:

如对本文有疑问，请在下面进行留言讨论，广大热心网友会与你互动！！ 点击进行留言回复

相关文章:

验证码：
最近更新的文章
大家感兴趣的文章
移动技术网