編集履歴

回答編集履歴

テキスト修正

2018/07/02 15:50

投稿

スコア9058

test CHANGED Viewed

@@ -304,6 +304,6 @@
 私見ですが、とりあえず上記９個は覚えておき、適切に使い分けられるようにして、
-どれにも当てはまらない状況のときは、ステータスコード一覧を調べてみる、
+どれにも当てはまらないように思える状況のときは、ステータスコード一覧を調べてみる、
-という対応で十分ではないかと思います。
+という対応で、まずは十分ではないかと思います。

テキスト修正

2018/07/02 15:50

投稿

jun68ykt

スコア9058

test CHANGED Viewed

@@ -138,7 +138,7 @@
 ステータスコードの200番台系、400番台系、500番台系のうち、どれを返せば良いか？について、
-極めて現場的なやり方の一例を示します。（※ウォータフォールではなくアジャイルです）
+極めて現場的なやり方の一例を示します。（※ウォーターフォールではなく、アジャイルです）
@@ -172,17 +172,21 @@
-> リクエストに問題がある場合は、**とりあえず**、 すべて400 Bad Request を返させることにしておいて、
+> リクエストに問題がある場合は、**とりあえず** すべて400 Bad Request を返すことに
-必要に応じて後で詳細化する。
+しておいて、必要に応じて後で詳細化する
+ことにします。
-ということにします。同様にサーバー側に起因するエラーの場合、細かく分ければ違う状況でも、とりあえず
+同様にサーバー側に起因するエラーの場合、細かく分ければ違う状況でも、とりあえず
-500 Internal Server Error を返すことにし、同様に、成功の場合は、200 OK だけを返させる
+500 Internal Server Error だけを返すことにし、同様に、成功の場合は、200 OK だけを
-という設計にしておいて、これに基づいて、サーバー側と、(JQueryなどで）フロントエンド 側を実装します。
+返す、という設計にしておいて、これに基づいて、サーバー側と、(JQueryなどで）フロントエンド側を
+実装していきます。
@@ -202,11 +206,11 @@
-__ログインしている状態でのみアクセス可能なリソース取得や更新をログインしていない状態で試みた場合は、__
+__ログインしている状態でのみアクセス可能なリソース取得や更新をログインしていない状態__
-__クライアント側でログインページを表示させたいので、他の 400 Bad Request のケースと分ける意味で、__
+__で試みた場合は、クライアント側でログインページを表示させたいので、他の 400 Bad Request__
-__401 Unauthorized を返させよう。__
+__のケースと分ける意味で、401 Unauthorized を返させよう。__
@@ -220,13 +224,13 @@
-だとか、必要に応じて分けていき、その詳細化に応じてサーバーとフロントで実装を追加すればよいです。
+だとか、必要に応じて分けていき、その詳細化に応じてサーバーとフロントで実装を追加します。
-逆にいえば
+逆にいえば、
-__リクエスト不正の場合は、ステータスコードは400だけにして、詳細はレスポンスボディに記述することにしよう。__
+__リクエスト不正の場合は、ステータスコードは400だけを使い、詳細はレスポンスボディに記述することにしよう。__
@@ -234,7 +238,7 @@
-また、成功の場合も同様で、初めは全て、200 OK を返すことにしていたけれど、何かの理由で、
+また、成功の場合も同様で、初めは全て、200 OK を返すことにしていたけれど、何かの理由で
@@ -298,6 +302,8 @@
-私見ですが、とりあえず上記９個を覚えておいて適切に使い分けることができ、どれにも当てはまらない
+私見ですが、とりあえず上記９個は覚えておき、適切に使い分けられるようにして、
-状況のときは、ステータスコード一覧を調べてみる、という対応で十分ではないかと思います。
+どれにも当てはまらない状況のときは、ステータスコード一覧を調べてみる、
+という対応で十分ではないかと思います。

テキスト追加

2018/07/02 15:11

投稿

jun68ykt

スコア9058

test CHANGED Viewed

@@ -118,7 +118,7 @@
 ---
-補足
+**補足 1**
@@ -127,3 +127,177 @@
 ところですので、最終的には、レスポンスコードの一覧を見たうえで、質問者様が
 「これがよさそう」と思うところを選べばよろしいかと思います。
+---
+**補足 2**
+ステータスコードの200番台系、400番台系、500番台系のうち、どれを返せば良いか？について、
+極めて現場的なやり方の一例を示します。（※ウォータフォールではなくアジャイルです）
+まず、
+- 成功の場合 → 200番台系
+- 失敗の場合：
+　　・リクエスト側に原因あり→ 400番台系
+　　・サーバー側に原因あり→ 500番台系
+と分けられますが、リクエスト側に原因あり（400番台系）のケースとして、Aという状況と、
+Bという状況の２つあった場合、
+__Aによるエラーと、Bによるエラーは、ともにリクエストに原因があるので、400番台系を返させることは__
+__決まっているが、Aの場合は何番で、Bの場合は何番にしたらよいだろう？__
+と考えていくわけですが、このとき、具体的に何番にしたらよいか分からないときは、
+> リクエストに問題がある場合は、**とりあえず**、 すべて400 Bad Request を返させることにしておいて、
+必要に応じて後で詳細化する。
+ということにします。同様にサーバー側に起因するエラーの場合、細かく分ければ違う状況でも、とりあえず
+500 Internal Server Error を返すことにし、同様に、成功の場合は、200 OK だけを返させる
+という設計にしておいて、これに基づいて、サーバー側と、(JQueryなどで）フロントエンド 側を実装します。
+つまり、
+- （200番台,400番台,500番台を返すべき状況では、）200, 400, 500 だけしか使わない
+という、ざっくりな設計で**とりあえず**始めます。
+その後、たとえば、
+__ログインしている状態でのみアクセス可能なリソース取得や更新をログインしていない状態で試みた場合は、__
+__クライアント側でログインページを表示させたいので、他の 400 Bad Request のケースと分ける意味で、__
+__401 Unauthorized を返させよう。__
+だとか、あるいは
+__ログインしているユーザーの権限レベルでは禁止されているリクエストを受けたときは、__
+__403 Forbidden を返させよう。__
+だとか、必要に応じて分けていき、その詳細化に応じてサーバーとフロントで実装を追加すればよいです。
+逆にいえば
+__リクエスト不正の場合は、ステータスコードは400だけにして、詳細はレスポンスボディに記述することにしよう。__
+という設計も、（いいか悪いかは別として、可能か不可能かでいえば、）出来なくはない、ということになります。
+また、成功の場合も同様で、初めは全て、200 OK を返すことにしていたけれど、何かの理由で、
+__POST で何らかのリソースを新規作成することに成功したことを、他のリクエストの成功とは__
+__区別したいので、その場合は、201 Created　を返させよう。__
+といった感じで詳細化していきます。
+---
+**補足 3**
+ご質問のタイトルである、「httpステータスコードについて」、
+> どのような値をサーバーから返したほうがよいのでしょうか？
+に応える良書を一冊挙げます。
+[Webを支える技術 -HTTP、URI、HTML、そしてREST (WEB+DB PRESS plus)](https://www.amazon.co.jp/dp/4774142042/)
+以下は、上記の書籍の目次、「第８章　ステータスコード」から引用しました。
+> **8.4 　よく使われるステータスコード**
+> **200 OK  — リクエスト成功**
+**201 Created — リソースの作成成功**
+　　**301 Moved Permanently — リソースの恒久的な移動**
+　　**303 See Other — 別URIの参照**
+　　**400 Bad Request ー リクエストの間違い**
+　　**401 Unauthorized — アクセス権不正**
+　　**404 Not Found — リソースの不在**
+　　**500 Internal Server Error — サーバ内部エラー**
+　　**503 Service Unavailable — サービス停止**
+私見ですが、とりあえず上記９個を覚えておいて適切に使い分けることができ、どれにも当てはまらない
+状況のときは、ステータスコード一覧を調べてみる、という対応で十分ではないかと思います。

テキスト追加

2018/07/02 14:51

投稿

jun68ykt

スコア9058

test CHANGED Viewed

@@ -113,3 +113,17 @@
 以上、参考になれば幸いです。
+---
+補足
+APIの設計時に、レスポンスコードに何を返すか？というのは、個人の考え方により、意見の分かれる
+ところですので、最終的には、レスポンスコードの一覧を見たうえで、質問者様が
+「これがよさそう」と思うところを選べばよろしいかと思います。

テキスト修正

2018/07/02 03:56

投稿

jun68ykt

スコア9058

test CHANGED Viewed

@@ -40,13 +40,19 @@
 レスポンスボディは空にするのがお約束です。
-204を返すケースの例としては、何らかの検索キーワードをクエリパラメータで与えて、
+204を返すケースの例としては、何らかのリソースをPOSTで新規
-サーバー側で検索したけれど該当するリソースが１件も無かった場合です。
+作成を要求したときに、その要求が成功して、特にレスポンスボディを
-リクエストの形式としては何ら不正はなく、検索も実行できた上で、何も返さないことも
+返す必要がないときに使うことがあります。
+また、GETリクエストにクエリパラメータを与えて、リソースの検索をした結果、
+検索は正常に行われたけれども、該当するものがなく、レスポンスボディとして
-正常終了のひとつとしてあり得る場合は、こちらを使います。
+空を返したい場合にも用いられることがあります。

テキスト追加

2018/07/02 03:52

投稿

jun68ykt

スコア9058

test CHANGED Viewed

@@ -8,9 +8,9 @@
 ということを、定義上、明確に示している（＝ステータスコードのメッセージ部分に、
-「存在しない」意味のテキストが含まれている。）ようなステータスコードとして
+「存在しない」意味のテキストが含まれている。）ようなステータスコードとして、
-よく使いものが２つあり、時と場合に応じてより適切なほうを選ぶとよいかと思います。
+よく使われるものが２つあり、時と場合に応じてより適切なほうを選ぶとよいかと思います。