ステータスコード

番号で結果を伝える

ここまで 200 / 201 / 204 / 404 を使ってきました。ここで整理します。

ステータスコードは 3 桁ですが、意味を決めているのは先頭の 1 桁です。

4 と 5 の違いが要点です。4 は相手に直してもらう、5 はこちらが直すという切り分けになっています。

よく使うもの

400 だけ、まだ使っていません。次の第5章で入力検証を書くときに登場します。価格が数値でない、商品名が空、といった場合に返します。

400 と 404 の見分け

迷いやすい 2 つです。

POST /items  価格が "abc"       → 400  送られた内容がおかしい
GET  /items/999                → 404  指定されたものが無い

依頼の中身がおかしいのが 400、依頼は正しいが対象が無いのが 404 です。

500 は書かない

500 は自分で返すものではありません。想定していなかった失敗が起きたときに、結果的にそうなるものです。

自分で res.status(500) と書く場面はほとんどありません。書いているとしたら、本当は 400 か 404 で表せる場合が多いはずです。第5章のエラーハンドリングで、この扱いを整えます。

迷ったら成功か失敗か

細かい番号に迷ったら、まず 2 か 4 か 5 かを決めてください。そのうえで表を見れば十分です。正確な番号より、成功と失敗が取り違えられていないことのほうがずっと大切です。

手を動かす

演習では、場面から適切なステータスコードを選ぶ関数を書きます。判断の基準を自分の中に作ってください。

1. fetched(取得できた) と updated(更新できた) は 200
2. created(新しく作った) は 201、deleted(削除した) は 204
3. invalid(送られた内容がおかしい) は 400、missing(対象が無い) は 404、それ以外は 500