Flask 学习-46.Flask-RESTX 生成 Swagger 文档入门教程
2023-06-13 09:12:28 时间
前言
Swagger API 文档是自动生成的,可从您的 API 的根 URL 获取。@api.doc()您可以使用装饰器配置文档。
Swagger UI 文档
默认flask-restx提供 Swagger UI 文档,从 API 的根 URL 提供
from flask import Flask
from flask_restx import Api, Resource, fields
app = Flask(__name__)
api = Api(app, version='1.0', title='Sample API',
description='A sample API',
)
@api.route('/my-resource/<id>')
@api.doc(params={'id': 'An ID'})
class MyResource(Resource):
def get(self, id):
return {}
@api.response(403, 'Not Authorized')
def post(self, id):
api.abort(403)
if __name__ == '__main__':
app.run(debug=True)
运行上面的代码并访问 API 的根 URL ( http://localhost:5000 ),您可以查看自动生成的 Swagger UI 文档。
点开详情可以看到参数的描述
doc 文档路径
您可以使用参数控制 Swagger UI 路径doc(默认为 API 根目录):
from flask import Flask
from flask_restx import Api, Resource, fields
app = Flask(__name__)
api = Api(app,
version='1.0',
title='Sample API',
description='A sample API',
doc='/doc' # swagger 文档访问地址
)
那么Swagger UI访问地址是http://127.0.0.1:5000/doc
禁用文档
要完全禁用 Swagger UI,请设置doc=False:
from flask import Flask
from flask_restx import Api
app = Flask(__name__)
api = Api(app, doc=False)
2022年第 12期《python接口web自动化+测试开发》课程,9月17号开学!
本期上课时间:2022年9月17号 - 2022年12月17号,周六周日上午9:00-11:00
报名费:报名费3000一人(周期3个月)
联系微信/QQ:283340479
相关文章
- 【重磅】Gym发布 8 年后,迎来第一个完整环境文档,强化学习入门更加简单化!
- Swagger2--自动生成接口文档工具学习
- 面向开放域密集检索多视图文档表示学习,微软提出MVR,性能SOTA!(ACL 2022)
- Flask 学习-52.Flask-RESTX 生成 Swagger 文档带上Authorization认证
- 零基础学习设计模式之模版方法模式(文档)
- 英语文档不看懂?学习Pinia就是这么简单---state篇
- 体系化文档化数字化管理学习暨2019个人年度总结
- Apache DolphinScheduler使用学习文档
- 印象笔记飞书文档语雀都起开!我本地部署一个知识库不香吗?
- Word VBA技术:将文档中的超链接转换为普通文本(取消超链接)
- ElasticSearch学习(二)——索引、文档简单操作
- MongoDB 排序文档详解数据库
- MySQL文档参考手册CHM版本(mysql文档chm)
- Linux下PHP文档指南(linuxphpdoc)
- Squid配置文档
- Linux学习之路:从PDF文档开始(linux 学习 pdf)
- Redis学习必备指南(redis学习文档)
- Redis文档极致的学习体验(最好的redis文档)
- Oracle优化器指南如何精确优化你的数据库(oracle优化器文档)
- 学习Oracle中API文档,路更顺畅(oracle中api文档)
- Oracle Bug文档之调查这些bug有何秘密(oracle bug文档)
- Asp.netXML文档进行添加删改操作的实例代码
- juqery学习之五文档处理插入
- jQuery学习笔记操作jQuery对象文档处理
- android帮助文档打开慢的三种解决方法
- js导出table数据到excel即导出为EXCEL文档的方法