以下のようなケースの場合、適切なHTTP レスポンスコードの番号をご教授いただけますでしょうか。
レスポンスコードの一覧を覗きましたが、何が適切なのか分かりませんでした。
想定ケース:
- (POST) REST API 新規登録要求
リミット発生:要求は正常だが、登録項目数上限の場合
400 Bad Request
が良いと思います。
前提として、クライアントサイドの不備によるエラーなので、4xx
を返すべきです。
登録項目数上限を超えている意味で不正な要求のため、4xx
および詳細なメッセージを返してPOSTするデータを整形してリトライしてもらう意図を伝えます。
4xx
の中で400
以外にふさわしいコードがあればそちらを採用できますが、適していそうな413 Payload Too Large
はペイロードに関するエラーなのでベストマッチとは言えないように感じます。
Microsoft REST API Guidelinesの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のエラーコードでは、LimitExceededException
やInvalidParameterValueException
の場合に400 Bad Request
を返します。
なお、この回答は類似質問Which response code for resources max. limit in REST API?の回答をとても参考にしました。