在 Python 的 FastAPI 自动生成的 OpenAPI/Swagger 文档页面中，如何添加更多错误 http 状态代码？

Question

FastAPI 自动生成 swagger/openapi 文档。

在 https://fastapi.tiangolo.com/tutorial/response-status-code 的教程中有一个示例

from fastapi import FastAPI
app = FastAPI()

@app.post("/items/", status_code=201)
async def create_item(name: str):
    return {"name": name}

如果您运行这样做，.../docs 页面会显示两个 http 响应选项：

状态代码 201 表示成功，状态代码 422 表示验证错误

以上教程为本页图片)

我想在文档中记录更多响应 status_code 描述，例如代码 403，“禁止”

虽然我可以在代码中运行这样的异常

raise HTTPException(status_code=403, detail="Forbidden")

我没有找到在自动生成的文档中描述它们的方法。

知道怎么做吗？

Answer 1

这是否解决了您的问题？

https://fastapi.tiangolo.com/advanced/additional-responses/

编辑

使用响应模型，您可以添加 API 可能 return 的不同响应。

from pydantic import BaseModel
# Define your models here like
class model200(BaseModel):
    message: str = ""
    
@api.get("/my-route/", responses={200: {"response": model200}, 404: {"response": model404}, 500: {"response": model500}})
    async def api_route():
        return "I'm a wonderful route"

这将提供您的响应模型示例，使用户更容易与 api

进行交互

在 Python 的 FastAPI 自动生成的 OpenAPI/Swagger 文档页面中，如何添加更多错误 http 状态代码？

In Python's FastAPI autogenerated OpenAPI/Swagger documentation page, how can I add more error http status codes?

fastapi