哇塞，巨大家优良！今天我们要聊一聊一个超级酷的东西，叫ZuoFlask Swagger。是不是听起来就hen高大巨大上呢？别急，我来磨蹭磨蹭给你说明白，保证你听完之后就像个细小高大手一样，Neng写出超级棒的API文档哦！

啥是Flask Swagger？

Flask Swagger是一个超级方便的工具， 它就像是Flask这玩意儿网站框架的一个细小帮手，专门用来帮我们写API文档的。API文档是啥呢？轻巧松就是告诉别人我们的网站或者应用有哪些功Neng，怎么用，就像是一张地图，让人一kan就明白。

怎么用Flask Swagger写API文档呢？

哇，这玩意儿就轻巧松了！先说说你需要在你的Flask项目中安装Flask Swagger。安装完之后你就Neng开头写API文档啦！下面我来给你举个例子，kankan怎么用Flask Swagger来定义一个API接口。

@ get_user:    user = get_user_from_database    if user:        return jsonify)    else:        return abort

这段代码是不是kan起来有点麻烦？别担心，我来磨蹭磨蹭说明白。这里我们用了一个叫的装饰器， 它就像是一个魔法棒，告诉Flask Swagger这玩意儿API接口是用来干啥的，需要哪些参数，还有成功或者输了的时候会返回啥信息。

写完API文档后怎么测试呢？

写完API文档后我们当然要测试一下kankan是不是真实的Neng按照我们写的来干活。Flask Swagger也帮我们想到了这一点，它给了一个测试客户端，Neng让我们轻巧松地测试API。就像这样：

def test_get_user:    response = client.get    assert response.status_code ==     assert json.loads == 'Alice'

这段代码就像是一个细小游戏， 我们告诉Flask Swagger我们想要测试啥，然后它就会帮我们检查API的响应是不是正确的。

Flask Swagger不仅Neng帮我们写API文档和测试API， 它还Neng帮我们创建一个超级酷的UI界面让我们Neng直观地kan到API文档，就像这样：

if __name__ == '__main__':    app.run

眼下我们Yi经Neng通过访问http://localhost:/api/docs来访问我们的API文档了。

优良啦，今天我们就聊到这里。和部署API。是不是觉得Flask Swagger超级有力巨大呢？赶紧去试试吧，相信你一定会成为一个API文档编写的高大手！