github:https://github.com/flasgger/flasgger
安装
pip install flasgger
示例
# -*- coding: utf-8 -*- from flask import Flask, jsonify from flasgger import Swagger app = Flask(__name__) swagger = Swagger(app) @app.route("/getInfo/<int:uid>") def get_info(uid): """获取用户信息 --- parameters: - name: uid in: path type: int required: true default: 1 description: 用户id responses: 200: description: 返回用户信息 examples: { code: 0, msg: "ok", data: { name: "Tom", uid: 1 }, } """ data = { "code": 0, "msg": "ok", "data": { "name": "Tom", "uid": uid } } return jsonify(data) if __name__ == '__main__': app.run(debug=True)
http://127.0.0.1:5000/apidocs/
访问文档
参考: