利用flasgger生成FlaskAPI文档

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/")
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/ 访问文档

参考: 利用swagger模块开发flask的api接口帮助文档