Я работаю над созданием rest api, и у меня есть вопрос о том, что обычно возвращается из get без совпадения. Например, если мой ресурс - «пользователи», и я выполняю вызов API с
http метод: ПОЛУЧИТЬ URL: api.mysite.com/users/123
Если существует «123», я верну http-код 200 с данными пользователя в теле ответа. Мой вопрос: какой http-код мне вернуть и что добавить в тело ответа, если нет пользователя с идентификатором 123?
Должен ли я просто вернуть код 200 и пустое тело?
Используйте 404, поскольку запрошенный ресурс (Пользователь) не существует.
10.4.5 404 не найдено
Сервер не нашел ничего, соответствующего Request-URI. Не указывается, является ли состояние временным или постоянным. Код состояния 410 (Gone) СЛЕДУЕТ использовать, если сервер знает через некоторый внутренне настраиваемый механизм, что старый ресурс постоянно недоступен и не имеет адреса пересылки. Этот код состояния обычно используется, когда сервер не желает точно раскрывать, почему запрос был отклонен, или когда другой ответ не применим. RFC 2616
GET, со строкой запроса ?hair=green, а код статуса результата должен быть 200 с пустой коллекцией {}.
- person MariuszS; 21.01.2014
Это ваш API, поэтому вы можете возвращать все, что хотите, но если вы говорили о стандарте HTTP-ответов, я бы посоветовал вам вернуть 404 (NOT FOUND) в этом случае, который выглядит более подходящим в этом случае. Потому что ресурс, к которому вы пытаетесь получить доступ, недоступен в этом месте.
404- Not Found означает, что сервер ничего не нашел. соответствие Request-URI.
С кодом состояния 404 вы также можете предоставить тело ответа или любой другой значимый заголовок с правильным сообщением об ошибке. Чтобы клиент мог это понять.
