読み方のヒント

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

第1節 POSTと本文

1.1 データを送る要求

前の章の 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