我想生成所有可用响应的描述(以及代码 200 示例),这些响应在代码中表示,如下所示。
from typing import Any
import uvicorn
from fastapi import FastAPI, HTTPException
router = FastAPI()
from pydantic import BaseModel
class FileItemBase(BaseModel):
current_project: str = "Test project"
class FileItemInDBBase(FileItemBase):
id: int
folder_path: str
class Config:
orm_mode = True
class FileResponse(FileItemInDBBase):
pass
@router.get("/", response_model=FileResponse)
def example_code() -> Any:
"""
# beautiful description
to demonstrate functionality
"""
demo=True
if demo:
raise HTTPException(418, "That is a teapot.")
if __name__ =="__main__":
uvicorn.run(router)
我得到的就是这样的描述。
当我尝试这个时 - 我收到错误响应(如预期)。
我想要的是示例响应中包含的错误的描述,如下所示。前端开发人员可以查看此描述并以正确的方式处理此类情况,而无需测试 API。
我知道如何在 OpenAPI规范内制作它。
有没有办法用 FastAPI 生成这个描述?
GCT1015
相关分类