如何编辑 Flask-plus 默认 swagger-UI 文本

How to edit Flask-plus default swagger-UI text

我正在开发一个简单的休息 api 目前只有两个 Get 方法。它工作正常等,并且当我导航到 url 时看起来非常棒,这要归功于内置的 swagger 文档。

但是我实际上并没有在任何地方看到 yaml 或 json 文件。如何更改屏幕截图中显示的标题和默认值?希望有可能不制作一个完整的单独的 yaml 或 json 文档?

我其实根本不想更改设计。我只想稍微编辑一下文本。

您在创建 API 时设置了标题:

api = Api(app, version='1.0', title='Your API Name', 
          description='A more complete description')

您通过创建命名空间将命名空间设置为 default 以外的其他名称:

ns = api.namespace('not-default', 
                   description='Whatever your namespace is')

然后在适当的命名空间中创建路由:

@ns.route(...)

这是对 API 进行分组的简便方法。如果需要,请参阅 Full Example 寻求帮助。