为响应模式 fastapi 构建 Pydantic 模式

Question

我有这样的数据响应

{
  "k9KNg_id": {
    "card_name": "item1",
    "price_updated_date": "2022-04-07T19:30:25.78Z",
    "card_img_id": "https://testingimg",
    "set_name": "some testing set",
    "set_tag": "mm3",
    "rarity": "rare",
    "price_normal": 32.99,
    "price_foil": 54.99
  },
  "EWrZ5_id": {
    "item_name": "item2",
    "price_updated_date": "2022-04-07T08:05:52.385Z",
    "item_name_img_id": "https://testingimg",
    "set_name": "testing set",
    "set_tag": "exp",
    "rarity": "super rare",
    "price_normal": null,
    "price_foil": 379.99
  },

，所以现在我尝试使用带有基本模型架构的 fastapi 编写此 api 返回。我应该如何编写架构？因为我有我的商品 ID，然后是我的商品详细信息。

 item_dict.update({
            "item_name": abc["item"]["name"],
            "price_updated_date": ed["prices"]["lastUpdatedAtUtc"],
            "item_img_id": item_img_url,
            "set_name": ed["name"],
            "set_tag": ed["abbreviation"],
            "rarity": ed["rarity"],
            "price_normal": normal_price,
            "price_foil": foil_price
        })
        data_return[ed["card_id"]] = ckd_dict
    return data_return

在我的 api 调用中，我只是发送一个非常简单的 fastapi 调用，

@router.get("/{item_name}")
async def search(item_name):
    item = get_item(item_url, item_url_type, item_name)
    return item 

我想为我的 fastapi 创建一个 response_model 以返回数据，但我不确定如何使用这种数据结构构建我的模式

Answer 1

首先将列表（字典）响应和卡结构分开：

class Card(BaseModel):
    card_name: str
    price_updated_date: datetime.datetime,
    card_img_id: str
    set_name: str
    set_tag: str
    rarity: str
    price_normal: float  # or maybe better, decimal.Decimal  - depends on your use case.
    price_foil: float  # same

然后，您可以在search Decorator中直接使用它，然后说您返回卡片词典：

@router.get("/{item_name}", response_model=Dict[str, Card])
async def search(item_name):
    pass

但是，您应该能够使用<代码> __根__ 定义a ：

class CardListResponse(BaseModel):
    __root__: Dict[str, Card]


@router.get("/{item_name}", response_model=CardListResponse)
async def search(item_name):
    pass