Python 中的 REST API 与 FastAPI 和 pydantic:模型中的只读属性

DrP*_*p3r 6 python rest python-3.x pydantic fastapi

假设一个 REST API 在资源 /foos 上定义了一个 POST 方法来创建一个新的 Foo。创建 Foo 时,Foo 的名称是一个输入参数(存在于请求正文中)。当服务器创建 Foo 时,它会为其分配一个 ID。此 ID 与 REST 响应中的名称一起返回。我正在寻找类似于 OpenAPI 中的 readOnly 的东西。

输入 JSON 应如下所示:

{
    "name": "bar"
}
Run Code Online (Sandbox Code Playgroud)

输出 JSON 应如下所示:

{
    "id": 123,
    "name": "bar"
}
Run Code Online (Sandbox Code Playgroud)

有没有办法重用相同的 pydantic 模型?或者是否有必要使用两种不同的模型?

class FooIn(BaseModel):
    name: str

class Foo(BaseModel):
    id: int
    name: str
Run Code Online (Sandbox Code Playgroud)

我在 pydantic 文档或 Field 类代码中找不到任何提及“只读”、“只读”或“只读”的内容。

谷歌搜索我发现一个帖子提到

id: int = Schema(..., readonly=True)
Run Code Online (Sandbox Code Playgroud)

但这似乎对我的用例没有影响。

小智 7

拥有多个模型就好了。您可以使用继承来减少代码重复:

from pydantic import BaseModel


# Properties to receive via API create/update
class Foo(BaseModel):
    name: str


# Properties to return via API
class FooDB(Foo):
    id: int
Run Code Online (Sandbox Code Playgroud)

顺便说一句,该文档 非常棒,对此进行更深入的探讨。

是取自官方全栈项目生成器的真实用户模型示例。您可以看到如何有多个模型根据上下文来定义用户模式。