在flask中使用swagger(flasgger使用方法及效果展示)
2024-10-12 03:35:51
一. 部分代码及效果
from flask import Flask
from flasgger import Swagger
import config
app = Flask(__name__)
app.config.from_object(config)
swagger_config = Swagger.DEFAULT_CONFIG
swagger_config['title'] = config.SWAGGER_TITLE # 配置大标题
swagger_config['description'] = config.SWAGGER_DESC # 配置公共描述内容
swagger_config['host'] = config.SWAGGER_HOST # 请求域名
# swagger_config['swagger_ui_bundle_js'] = '//unpkg.com/swagger-ui-dist@3/swagger-ui-bundle.js'
# swagger_config['swagger_ui_standalone_preset_js'] = '//unpkg.com/swagger-ui-dist@3/swagger-ui-standalone-preset.js'
# swagger_config['jquery_js'] = '//unpkg.com/jquery@2.2.4/dist/jquery.min.js'
# swagger_config['swagger_ui_css'] = '//unpkg.com/swagger-ui-dist@3/swagger-ui.css'
Swagger(app, config=swagger_config)
@blueprint.route('/register/', methods=['POST'])
def register():
"""
用户注册
---
tags:
- 用户相关接口
description:
用户注册接口,json格式
parameters:
- name: body
in: body
required: true
schema:
id: 用户注册
required:
- username
- password
- inn_name
properties:
username:
type: string
description: 用户名.
password:
type: string
description: 密码.
inn_name:
type: string
description: 客栈名称.
phone:
type: string
description: 手机号.
wx:
type: string
description: 微信.
responses:
201:
description: 注册成功
example: {'code':1,'message':注册成功}
406:
description: 注册有误,参数有误等
"""
pass
二. 大致介绍及详细文档推荐
flasgger配置文件解析:
- 在flasgger的配置文件中,以yaml的格式描述了flasgger页面的内容;
- tags标签中可以放置对这个api的描述和说明;
- parameters标签中可以放置这个api所需的参数,如果是GET方法,可以放置url中附带的请求参数,如果是POST方法,可以将参数放置在schema子标签下面;
- responses标签中可以放置返回的信息,以状态码的形式分别列出,每个状态码下可以用schema标签放置返回实体的格式;
只是简单记录,其他可以看下面一些链接
使用swagger 生成 Flask RESTful API
swagger文档在线编辑样例
swagger和openAPI: 描述参数
flasgger
最新文章
- C++文本处理_文件读写
- 试用Jenkins 2 的 Pipeline 项目
- org.springframework.web.servlet.PageNotFound No mapping found for HTTP request with URI [/AssetRepair/assetRepairController/test.do] in DispatcherServlet with name 'assetrepair'
- canvas-绘制时钟
- JavaWeb开发好资料
- NSRange
- IQueryable接口与IEnumberable区别
- PHP 学习笔记 (一)
- wdcp对default站点开启apache url重写功能
- iOS 网络与多线程--6.下载并保存网络图片
- VSTO学习笔记(四)从SharePoint 2010中下载文件
- DDD:四色原型中Role的 “六” 种实现方式和PHP的Swoole扩展
- 隐马尔科夫模型HMM(三)鲍姆-韦尔奇算法求解HMM参数
- 怎么为WebStorm更换主题 修改字体样式
- android官网文档学习笔记
- Keras 处理 不平衡的数据的分类问题 imbalance data 或者 highly skewed data
- iis日志分析软件及大文本切割软件下载
- 用SDWebImage加载FLAnimatedImage
- IntelliJ IDEA导出Java 可执行Jar包
- Android-——多线程之Handler(转)
热门文章
- JQuery禁止/恢复按钮readonly和disabled小结
- 类修饰符为abstract与final
- php的TS和NTS的区别
- memcache 相关
- angluarjs中页面初始化的时候会出现语法{{}}在页面中问题
- [DOM基础]offsetHeight,clientHeight,scrollHeight,innerHeight,outerHeight等属性的解释
- jQuery计算文本宽度和input标签根据输入字符动态自适应宽度的实现
- TS学习随笔(一)->;安装和基本数据类型
- 熊猫ios手游直播教程 苹果投屏电脑
- GIS开发之数据查询