1

以下のようなケースの場合、適切なHTTP レスポンスコードの番号をご教授いただけますでしょうか。

レスポンスコードの一覧を覗きましたが、何が適切なのか分かりませんでした。

想定ケース:

  • (POST) REST API 新規登録要求
    リミット発生:要求は正常だが、登録項目数上限の場合

1 件の回答 1

2

400 Bad Requestが良いと思います。

前提として、クライアントサイドの不備によるエラーなので、4xxを返すべきです。
登録項目数上限を超えている意味で不正な要求のため、4xxおよび詳細なメッセージを返してPOSTするデータを整形してリトライしてもらう意図を伝えます。

4xxの中で400以外にふさわしいコードがあればそちらを採用できますが、適していそうな413 Payload Too Largeはペイロードに関するエラーなのでベストマッチとは言えないように感じます。

Microsoft REST API Guidelines16.2.1. Error responseが良くまとまっていますので引用します。

引用ここから

16.2.1. Error response

Services MUST provide an error response if a caller requests an unsupported feature found in the feature allow list. The error response MUST be an HTTP status code from the 4xx series, indicating that the request cannot be fulfilled. Unless a more specific error status is appropriate for the given request, services SHOULD return "400 Bad Request" and an error payload conforming to the error response guidance provided in the Microsoft REST API Guidelines. Services SHOULD include enough detail in the response message for a developer to determine exactly what portion of the request is not supported.

Example:

GET https://api.contoso.com/v1.0/people?$orderBy=name HTTP/1.1
Accept: application/json
HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "error": {
    "code": "ErrorUnsupportedOrderBy",
    "message": "Ordering by name is not supported." 
  }
}

引用ここまで

類例としてAWS S3のエラーコードでは、LimitExceededExceptionInvalidParameterValueExceptionの場合に400 Bad Requestを返します。
なお、この回答は類似質問Which response code for resources max. limit in REST API?の回答をとても参考にしました。

1
  • ご回答ありがとうございました。 また参考ページやAWSでの事例など、とても分かりやすい内容で助かりました。
    – sanlike
    Commented 2022年8月10日 1:12

この質問に回答するには、ログインする必要があります。

求めていた回答ではありませんか? のタグが付いた他の質問を参照する。