python flask api接口开发编程_利用swagger模块开发flask的api接口帮助文档

swagger官网称其为世界最流行的api工具。用过的都说好。我已经深有体会。

附上官网编辑页面。只需要拷贝相应的文件就可以实现效果

下面主要讲解一下在python的flask框架下，如何使用这款屌炸天的应用。pip install flasgger

2、写一个简单的web例子。

以下是简写代码#coding:utf8

import sys

reload(sys)

sys.setdefaultencoding('utf8')

from flask import Flask,Blueprint,render_template,request,redirect,jsonify

from flasgger import Swagger,swag_from

app = Flask(__name__)

swagger = Swagger(app)

#swagger展现api接口方法集合，访问http://127.0.0.1:9001/apidocs/即可

@app.route('/api/publish/k8sbuildjob/',methods=['POST'])

@swag_from('apiDescYmal/color.yml')

def build():

return jsonify({})

if __name__ == '__main__':

app.run(host='0.0.0.0',port=9001,debug=True)

3、描述文件。示例color.yml发布