サーバー上の別ユーザーのファイル処理でのHTTPステータスコード

Question

Web API において、下記の場合はHTTPステータスコードは何を返すのが
適切と考えられますでしょうか。

###前提
・ユーザーA・Bの2人がおり、2人の権限は同等のもの。
・ユーザーAがAPIのサーバーに あるファイルをアップロード済み。
・ユーザーBがAPIの処理を呼び出し、アップロードされたファイルの解析・結果のDBへの登録が行われる。

###質問
ユーザーBのAPI呼び出しで、アップロードされたファイルの解析時に
不正なファイル形式（内容が不正）とする場合、返すべきHTTPステータスコードは何が適切と思われますでしょうか。

よろしくお願いいたします。

Comments

[maisumakun]

そもそも論として、「不適当なファイルをAがアップロードしようとした時点でエラーにする」という設計のほうが自然ではないのかと思うのですが、そうできない理由はありますでしょうか。

[koh1]

ありがとうございます。Aによるアップロードというのが、FTPでのアップ（ミラーリングによる）を想定しており、そこに処理は入れられない状況なのです。

Answer 1

「不適切なファイルがアップロードされている」ということはつまりサーバの状態の不整合なので、意味合い的には500 Internal Server Errorが適当かなと思います。

ただし、APIレスポンスとして500を返すのは本物のサーバエラーと区別がつかなくなるので、実用的には200を返して、中身で状況を知らせるという方がいいかもしれません。

---

そもそもの設計として、（何か理由があるのかもしれませんが）「AさんがFTPなどで上げる」→「Bさんが読み込みの指示をする」という2ステップを取るのが冗長な気もします。自分で実装するのなら、「AさんがFTPなどで上げる」→「それをcronで読み取って自動登録」のようなフローで考えます。

Answer 2

200では？
HTTPプロトコル的には何の問題も無いので。

HTTPより上位のメッセージでエラーを返すべきと思います。

Answer 3

ご回答いただいた方々、ありがとうございました。
今回の場合、Bのリクエスト自体は正常なのでステータスコードは200で、ボディに情報を入れて返そうと思います。

処理の流れ上、400または500のステータスコードが返ることがない状況が最初気になりましたが、
ファイルのアップがWebAPIであればそこで400を返すところ、FTPでのアップのため400を返す機会がないだけ、
ということで落ち着きそうです。