FastAPI – 在请求体中接收对象列表

在本文中，我们将介绍如何在FastAPI中接收包含对象列表的请求体。FastAPI是一个现代化的Python框架，可以轻松地构建高性能的Web应用程序。它结合了快速（Fast）和API开发的特点，具有出色的性能和开发效率。通过FastAPI，我们可以轻松地处理各种类型的HTTP请求，包括接收包含对象列表的请求体。

阅读更多：FastAPI 教程

使用Pydantic模型定义请求体模式

在FastAPI中，我们使用Pydantic模型来定义请求体的数据模式。Pydantic是一个强大的数据验证和序列化库，可以帮助我们定义和验证数据模型。我们可以通过继承BaseModel类来创建Pydantic模型，并定义每个字段的类型和验证规则。

下面是一个示例，展示了如何使用Pydantic模型来定义一个包含对象列表的请求体模式：

from typing import List
from pydantic import BaseModel

class Item(BaseModel):
    name: str
    price: float

class RequestBody(BaseModel):
    items: List[Item]

在上面的示例中，我们定义了两个Pydantic模型：Item和RequestBody。Item模型表示一个对象，包含一个名为name的字符串字段和一个名为price的浮点数字段。RequestBody模型表示请求体，包含一个名为items的对象列表字段，其中每个对象都是Item类型。

创建路由接受对象列表的请求体

要在FastAPI中接收包含对象列表的请求体，我们可以创建一个路由，并使用RequestBody模型来定义请求体的数据类型。下面是一个示例：

from fastapi import FastAPI
from typing import List
from pydantic import BaseModel

app = FastAPI()

class Item(BaseModel):
    name: str
    price: float

class RequestBody(BaseModel):
    items: List[Item]

@app.post("/items/")
async def create_items(request_body: RequestBody):
    for item in request_body.items:
        # 处理每个对象
        ...

    return {"message": "Items created"}

在上面的示例中，我们创建了一个名为create_items的路由，并使用@app.post装饰器将其标记为POST请求。其中，request_body参数的类型是RequestBody，表示请求体的数据类型。

在路由处理函数中，我们可以通过request_body.items来访问请求体中的对象列表，并对每个对象进行处理。我们可以根据实际需求，在循环中执行一些操作，比如将对象保存到数据库中。

发送包含对象列表的请求

要发送一个包含对象列表的请求，我们可以使用HTTP客户端库，如requests库。

下面是一个示例，展示了如何使用requests库发送一个包含对象列表的POST请求：

import requests

data = {
    "items": [
        {"name": "item1", "price": 10.99},
        {"name": "item2", "price": 20.99},
        {"name": "item3", "price": 30.99}
    ]
}

response = requests.post("http://localhost:8000/items/", json=data)
print(response.json())

在上面的示例中，我们创建了一个data字典，其中包含一个名为items的键，对应一个对象列表。我们将这个字典作为json参数传递给requests.post方法，以将其转换为JSON格式的请求体。