在 FastAPI 中,你可以使用 OpenAPI 的元数据来配置文档生成的细节,包括标题、描述、版本号等。你还可以使用 FastAPI 的 redoc_url 和 swagger_ui_oauth2_redirect_url 参数来自定义文档的 URL。

以下是一个简单的例子,演示如何使用元数据和自定义文档 URL:
from fastapi import FastAPI

app = FastAPI(
    title="My FastAPI App",
    description="This is a sample FastAPI application.",
    version="1.0.0",
    redoc_url="/docs",
    swagger_ui_oauth2_redirect_url="/docs/oauth2-redirect",
)

@app.get("/")
async def read_root():
    return {"message": "Hello, World!"}

在这个例子中:

  •  title 参数用于设置文档的标题。

  •  description 参数用于设置文档的描述。

  •  version 参数用于设置文档的版本号。

  •  redoc_url 参数用于指定 Redoc 的 URL。在这里,我们将 Redoc 的文档页设置为 /docs。

  •  swagger_ui_oauth2_redirect_url 参数用于指定 Swagger UI 的 OAuth2 重定向 URL。在这里,我们将其设置为 /docs/oauth2-redirect。


在应用程序启动后,你可以访问文档页面,例如 http://localhost:8000/docs(或你的自定义 URL)。这里,我们使用了 Redoc 的文档页,但你也可以使用 Swagger UI,具体取决于你的偏好。

在实际应用中,你可能还需要配置其他元数据,如联系信息、许可证等。这些元数据将被包含在生成的 OpenAPI 文档中。

总之,通过使用 FastAPI 的应用程序构造函数参数,你可以轻松配置生成的文档的各个方面,以满足你的需求。


转载请注明出处:http://www.pingtaimeng.com/article/detail/7399/FastAPI