Как редактировать текст Swagger-UI Flask-плюс по умолчанию

Question

Я разрабатываю простой API отдыха, в котором пока есть только два метода Get. Он работает нормально и т. Д., И выглядит очень хорошо, когда я перехожу на URL благодаря встроенной документации Swagger.

Однако я нигде не вижу файла yaml или json. Как изменить заголовок и значения по умолчанию, как показано на скриншоте? Надеюсь, это возможно без создания отдельного документа yaml или json?

Я вообще не хочу менять дизайн. Я только хочу немного отредактировать текст.

Answer 1

Вы устанавливаете заголовок при создании API:

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

Вы задаете для пространства имен что-то отличное от по умолчанию , создавая пространство имен:

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

Затем вы создаете свои маршруты в соответствующем пространстве имен:

@ns.route(...)

Это удобный способ группировки ваших API. См. Полный пример для получения помощи, если это необходимо.