python - body 是什么？ `from fastapi import Body`

Question

在documentation在其他地方，我看到使用了 Body 但不知道它是什么。

谁能解释一下这三个选项是什么意思？

from fastapi import Body
from pydantic import BaseModel

class MyModel(BaseModel):
    body1: None
    body2: Body(None)
    body3: Body(...)

Answer 1

当您使用 Pydantic 模型时，您不需要使用 Body。

你可以这样写:

from pydantic import BaseModel, Schema

class MyModel(BaseModel):
    body1: None
    body2: Schema(None)
    body3: Schema(...)

Body 仅在路径操作参数中使用，当您需要强制 FastAPI 理解参数是作为主体的一部分接收的(例如，而不是查询范围)。在使用“单一”类型(单个值，如 int、str)的参数时，您只需要显式使用 Body。如果您使用 Pydantic 模型、列表或类似类型的东西，则无需显式使用 Body。

如果需要，您还可以使用 Body 添加额外的元数据。如标题、示例等。

在文档中阅读更多相关信息:https://fastapi.tiangolo.com/tutorial/body/