読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第2節 Pydanticで項目を定義する

2.2 Pythonの名前とJSONの名前

JSONの項目名は pickupAt や productId のように、2つめの単語を大文字で始めます。Pythonでは、pickup_at のように _ でつなぐのが一般的な書き方です。

場所書き方例
JSON(APIの外側)2つめの単語を大文字で始めるpickupAt、productId
Python(関数の中)_ でつなぐpickup_at、product_id

Field(alias="pickupAt") は、「JSONでは pickupAt という名前で受け取る」という指定です。関数の中では reservation.pickup_at と書きます。

AwareDatetime は、時差の付いた日時だけを受け取る型です。"2026-11-02T08:00:00+09:00" は受け取り、+09:00 のない "2026-11-02T08:00" は断ります。時差がなぜ必要かは、次の章で詳しく扱います。

items: list[ReservationItemIn] は、明細のモデルを要素とするリストです。明細の1つ1つも、ReservationItemIn の形で検査されます。

関数の中では、reservation.name のように、. で項目を取り出します。辞書の ["name"] ではありません。

解答

pickupAt です。モデルに定義した項目が本文にないため、"type": "missing"、"msg": "Field required"(必須の項目がない)として422で断られます。

7 / 20