みなさんこんにちは、あべ いさぢです。

今回は「Laravelでreturn response()->jsonを使った時のステータスコード」のまとめになります。

ステータスコードとは

サーバーが処理結果をフロントに伝えるための番号です。

ステータスコードは「成功(2xx)」・「クライアントエラー(4xx)」・「サーバーエラー(5xx)」の3種類があります。

それぞれ見ていきます。

成功(2xx)

下記になります。

コード	  意味	         挙動
200	      OK	         正常に処理された
201	      Created	     新規データ作成成功
204	      No Content	 成功だがレスポンスなし

200はテーブルのデータの取得に成功してフロントに値を返すことができるなどの場合です。

201はレコード・ファイル・トークンの作成ができた場合です。

204の意味がよく分からないと思います。

値を返さないので例えば処理をしてフロントに何も返さない更新や削除が該当します。

クライアントエラー(4xx)

クライアントエラーはフロントから送られたリクエストの内容に問題があったりURLが間違っていてリクエストを送れないなどの場合のエラーです。

下記があります。

コード	     意味	              挙動
400	         Bad Request	      リクエストが不正
401	         Unauthorized	      認証が必要
403	         Forbidden	          アクセス禁止
404	         Not Found	          データなし
422          Validation Error     バリデーションエラー

400の意味は送信データの形式が壊れていたり必須パラメーターがない場合に起きるエラーです。

401はログイン情報がない・トークンがない場合に起きるエラーです。

403は認証には通っているけどその操作をする権限がない時に起きるエラーです。

404はURL・APIのURLが存在しない時に起きるエラーです。

422の意味は送信データのバリデーションに引っかかった場合に起きるエラーです。

サーバーエラー(5xx)

コードが間違っていたりテーブルがないなどのバックエンド側のエラーです。

下記があります。

コード	意味
500	    サーバーエラー
503     サービス停止

500はPHPのコードが間違っていたりテーブルが存在しない場合に起きるエラーです。

503はサーバーに負荷がかかり過ぎて停止していたりメンテナンスでサーバーが停止しているなどの場合に起きるエラーです。

サーバーが止まっているということです。