読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
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