发布API文档
生成API文档后，我们还需要将文档发布出去，以便其他开发人员可以访问。在本节中，我们将介绍两种常见的方法来发布API文档：使用Swagger UI和使用Redoc。
使用Swagger UI
Swagger是一个流行的API文档工具，它可以自动将API文档呈现为交互式UI。Flask-RESTful提供了一个名为flasgger的扩展，可以将生成的API文档转换为Swagger UI。
首先，我们需要安装flasgger扩展：
pip install flasgger然后，我们需要使用flasgger的Swagger类来配置Swagger UI。以下是一个例子：
from flask import Flask
from flask_restful import Api, Resource, fields, marshal_with
from flasgger import Swagger
app = Flask(__name__)
api = Api(app)
resource_fields = {
'name': fields.String,
'age': fields.Integer,
'gender': fields.String,
}
class User(Resource):
@marshal_with(resource_fields)
def get(self, user_id):
# Get user from database
user = {'name': 'John Doe', 'age': 30, 'gender': 'male'}
return user
api.add_resource(User, '/users/<int:user_id>', endpoint='user')
swagger = Swagger(app)
if __name__ == '__main__':
app.run(debug=True)在上面的例子中，我们导入了flasgger的Swagger类，并创建了一个swagger对象。然后，在程序运行时，我们可以通过访问http://localhost:5000/apidocs/来查看生成的Swagger UI。
