Устранение неоднозначности кода состояния ответа RESTful API

Question

Я разрабатываю RESTful API и у меня есть вопрос о наиболее подходящих кодах статуса ответа для определенных сценариев.

Рассмотрим случай, когда клиент делает запрос GET для ресурса. Как устранить неоднозначность ответа «не найден» для случая, когда ресурс законно не существует, по сравнению со случаем, когда может быть незначительное прерывание обслуживания (во время развертывания и т. Д.).

Answer 1

W3C определяет очень конкретные коды состояния почти для всех случаев, о которых вы только можете подумать. Для ваших конкретных потребностей:

• Не найдено: 404
• Сервис недоступен: 503

Answer 2

Отправить код состояния 404 для «Не найдено»

Отправьте некоторые ошибки серии 500 для условий ошибки на стороне сервера.