Коды состояния HTTP при ошибках в теле запроса
Может кто-нибудь пояснить, какие коды состояния мне следует ожидать в следующих ситуациях? Например, я отправляю запрос POST с таким форматом тела:
{
"id": 321,
"username": "tombrown",
"email": "[email protected]",
"password": "qwerty123",
"activated": true
}
Итак, вопросы:
1) Должен ли сервер возвращать 400, если я указываю данные неправильного типа, например, «id»: «threeetwoone» вместо int, «activate»: «yes» вместо логического и т. д. Или сервер должен скорее возвращать здесь 422?
2) Значение id должно быть int, но на самом деле это long int, например 9223372036854774700.
3) Некоторые поля отсутствуют в теле, например Я пытаюсь отправить:
{
"id": 321,
"username": "tombrown",
"activated": true
}
Должны ли эти примеры вызывать 400, 422 или другие варианты? Какая реакция должна быть правильной?
Ответы 1
Если JSON - это синтаксически недействительный, вернуть 400. Если JSON - это синтаксически действительный, но его контент недействителен, верните 422, чтобы указать, что объект запроса не может быть обработан сервером.
См. Следующую цитату из RFC 4918 (для вашей ситуации просто прочтите JSON, когда там написано XML):
11.2. 422 Unprocessable Entity
The
422(Unprocessable Entity) status code means the server understands the content type of the request entity (hence a415(Unsupported Media Type) status code is inappropriate), and the syntax of the request entity is correct (thus a400(Bad Request) status code is inappropriate) but was unable to process the contained instructions. For example, this error condition may occur if an XML request body contains well-formed (i.e., syntactically correct), but semantically erroneous, XML instructions.
@ Michael12345 Насколько я понимаю, синтаксис полезной нагрузки все еще действителен, однако сервер не может обработать объект. Я бы придерживался 422.
Спасибо! Да, JSON синтаксически действителен. В принципе, у меня бывает ситуация, когда неправильный тип данных вызывает ошибку 500 с сервера, это меня немного смутило.