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发布