是否可以使用flask-RESTplus自动生成swagger元数据json？

Question

我已经使用python库flask-Restplus创建了一个api，并将其关联的swagger ui暴露给例如http://serverURL:80/api/v1/documentation。

有没有可能以某种方式将这个文档页面公开为json？我知道使用.Net库"Swashbuckle“可以做到这一点(例如，http://serverURL:80/api/v1/documentation.json将以json格式返回文档)。我正在寻找一种在python中实现同样类型的功能的方法。

Answer 1

事实证明，swagger ui的这个.json不是在文档页面中生成的，而是使用flask_Restplus库自动生成根目录的。例如，"http://serverURL:80/api/v1/swagger.json“是包含此页面的url，而不是我的文档url "http://serverURL:80/api/v1/documentation”。我不需要做任何代码修改就能让它工作。

Answer 2

作为运行开发服务器和打开浏览器的替代方法，下面是一些将Swagger规范提取为JSON的代码：

from flask import Flask
from flask_restplus import Api

app = Flask(__name__)
api = Api(app)

def print_swagger_file():
    with app.app_context():
        print(json.dumps(api.__schema__, indent=4))

Answer 3

要获取swagger.json，请转到:/swagger.json，您将获得swagger.json。使用此swagger.json生成文档。转到https://editor.swagger.io并添加你的swagger。