flask項目集成swagger的方法

更新時間：2020年12月09日 16:02:47 作者：種樹飛

這篇文章主要介紹了flask項目集成swagger的方法，幫助大家更好的理解和使用flask框架，感興趣的朋友可以了解下

　　此次主要介紹介紹在flask框架中如何集成swagger文檔，我們知道以前給同事提供接口文檔主要是寫一個文檔，當遇到頻繁修改時，就需要更新文檔非常麻煩，這時swagger文檔就出現(xiàn)了，一個在線得接口文檔，同事可以在線上查看接口文檔，當需要修改接口時秩序修改對應得代碼，文檔也會隨之更新。如下圖所示。

　　此次集成參考flask-restplus官方文檔，flask-restplus框架是flask-restful框架的一個加強版，類似django框架的rest framework框架，應用前得先安裝框架執(zhí)行命令：

pip install flask-restplus

　　然后結合官網(wǎng)寫個簡單示例感受一下：

from flask import Flask
from flask_restplus import Api, Resource, fields, reqparse

app = Flask(__name__)
api = Api(app, version='1.0', title='TodoMVC API', description='A simple TodoMVC API',)

ns = api.namespace('todo', description='TODO operations')               # 模塊命名空間

todo = api.model('Todo', {                               # 返回值模型
  'id': fields.Integer(readonly=True, description='The task unique identifier'),
  'task': fields.String(required=True, description='The task details')
})

parser = reqparse.RequestParser()                      # 參數(shù)模型
parser.add_argument('id', type=str, required=True, help="id")
parser.add_argument('name', type=str, required=True, help="名稱")
parser.add_argument('volume', type=int, required=True, help="方量")


class TodoDAO(Resource):
  def __init__(self, *args, **kwargs):
    super().__init__(*args, **kwargs)
    self.params = parser.parse_args()

  @ns.expect(parser)                  # 用于解析對應文檔參數(shù)，             
  @ns.response(200, "success response", todo)      # 對應解析文檔返回值
  def get(self):
    return self.params


ns.add_resource(TodoDAO, "/to", endpoint="to_do")

app.run()

我們啟動得地址為127.0.0.1:5000得地址，然后我們只需在瀏覽器打開即可查看自己寫好得api文檔，如下圖：