Flasgger 使用

引言

• Swagger是一款Restful接口的文档在线自动生成+功能测试功能软件；
• 通过swagger能够清晰、便捷地调试符合Restful规范的API；
• 在flask框架中使用的swagger即为flasgger，flasgger是flask支持的swagger UI，便于调试使用flask框架搭建的web api接口；

安装

pip3 install flasgger；

flasgger配置文件解析

@app.route('/api/<string:language>/', methods=['GET'])
def index(language):
    """
    This is the language awesomeness API
    Call this api passing a language name and get back its features
    ---
    tags:
      - Awesomeness Language API
    parameters:
      - name: language
        in: path
        type: string
        required: true
        description: The language name
      - name: size
        in: query
        type: integer
        description: size of awesomeness
    responses:
      500:
        description: Error The language is not awesome!
      200:
        description: A language with