FlaskAPI-交互式文档与includ_router

1 FastAPI 交互式 API 文档

FastAPI 提供了内置的交互式 API 文档，使开发者能够轻松了解和测试 API 的各个端点。这个文档是自动生成的，基于 OpenAPI 规范，支持 Swagger UI 和 ReDoc 两种交互式界面。通过 FastAPI 的交互式 API 文档，开发者能够更轻松地理解和使用 API，提高开发效率在运行 FastAPI 应用时，Uvicorn 同时启动了交互式 API 文档服务。
默认情况下，你可以通过访问 http://127.0.0.1:8000/docs 来打开 Swagger UI 风格的文档：

2 路径操作装饰器

装饰器位置：路径操作装饰器位于函数定义的上方，用于将函数与特定的 HTTP 请求路径和方法关联起来。一般形式：@app.请求方法(“路径”)，其中app是ASGI 应用对象，请求方法可以是get、post、put、delete等 HTTP 请求方法，路径是一个字符串，表示请求的 URL 路径。如下：

app = FastAPI()

@app.get("/")
def get_user():
    return {"Hello": "World"}

@app.post("/")
def set_user():
    return {"Hello": "World"}

@app.put("/")
def put_user():
    return {"Hello": "World"}
@app.delete("/")
def delete_user():
    return {"Hello": "World"}

我们可以设置交互式API文档，比如说对端点设置分类，对端点设置摘要。

@app.get("/",tags=["a"],summary="获取用户")
def get_user():
    return {"Hello": "World"}

@app.post("/",tags=["a"],summary="设置用户")
def set_user():
    return {"Hello": "World"}

@app.put("/",tags=["b"],summary="更新用户")
def put_user():
    return {"Hello": "World"}
@app.delete("/",tags=["b"],summary="删除用户")
def delete_user():
    return {"Hello": "World"}

路由装饰器部分参数

2 include_router

include_router通常用于将多个相关的路由（由 APIRouter 实例定义）整合到主应用（由 FastAPI 实例定义）中。这样做的好处是可以对路由进行模块化管理，便于大型项目中不同功能模块的路由划分与组织，使得代码结构更加清晰，各个模块的路由可以独立开发、维护和测试。

在 FastAPI 中，include_router是FastAPI应用实例（通常是app）的一个方法。基本语法是：app.include_router(router, **parameters)。其中router是一个APIRouter实例，它包含了一组相关的路由；app是FlaskAPI实例，**parameters表示可以传递多个可选参数来配置路由的行为。如下：

  app.include_router(app1)
    app.include_router(app2, prefix="/good")
    uvicorn.run(app, host="127.0.0.1", port=8000)

app1,app2是两个APIRouter实例，prefix为app2中的路由都加上了/good为前缀。APIRouter对象与FlaskAPI对象相似，使用路由装饰器处理相应URI对应的请求。

常用参数