読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
前の章の GET /products は、データを受け取るだけの要求でした。予約を受け付けるには、予約の内容をサーバーへ送る必要があります。
POST /reservations HTTP/1.1
content-type: application/json
{"name": "田中", "pickupAt": "2026-11-02T08:00:00+09:00", "items": [{"productId": "p001", "quantity": 1}, {"productId": "p002", "quantity": 2}]}
| 部分 | この例 | 意味 |
|---|---|---|
| メソッド | POST | データを送って、処理を頼む |
| パス | /reservations | 予約について |
| 本文 | {"name": "田中", …} | 送る予約の内容。JSONで書く |
GET の要求には本文がありませんでしたが、POST の要求には本文を付けます。本文の項目は次のとおりです。
| 項目 | 意味 | 例 |
|---|---|---|
name | 受け取りのときに使う名前 | "田中" |
pickupAt | 受け取りの日時(日本時間の時差 +09:00 付き) | "2026-11-02T08:00:00+09:00" |
items | 明細。商品IDと個数の組のリスト | [{"productId": "p001", "quantity": 1}] |
予約のIDや状態、金額は送りません。IDと状態はサーバーが決め、金額はサーバーが商品の価格から計算します。送る側が自由に書き換えられる値に、金額を任せないためです。
2 / 20