HTTP-ответ, получающий ресурс, когда доступны только частичные данные

Question

Приносим извинения, если для этого есть ответ. Я нашел связанные вопросы (например, HTTP status code for a partial successful request), но не совсем то же самое.

Я создаю API, который возвращает данные, которые агрегируются из нескольких источников. Иногда некоторая критическая часть данных недоступна, и клиент должен быть осведомлен, а данные об ошибках включены в ответ.

Помимо серьезности недостающего поля (ов), остальная часть ресурса является действительной и полезной и может рассматриваться как частичное обновление (например, если у вас есть разрешения на просмотр части ресурса).

До сих пор варианты

1. возвращение 200, считают его частичный ресурс, обрабатывать поля данных об ошибке в приложении, как вы бы с любыми другими данными
2. возвращение 207, чтобы подчеркнуть, что это не в полной мере успешно, но 207 не является строго HTTP.
3. возвращение 500 и обрабатывать успешно возвращаемые данные в приложении, как на 200

Я неравнодушен к варианту 1, но я не полностью убежден. Есть ли ясный способ справиться с этим? Возможно, определите конкретный content-type?

Answer 1

У вас отсутствует пункт здесь, потому что 500 указывает на отказ системы или цепи связи, а так как данные возвращаются, следует предположить, что ресурс существует и найден. То, что указало ОП, является частичным результатом, подразумевающим составные данные, относящиеся к ресурсу. Это необязательно вне сферы действия http, которая выполнила свою работу через успешную 200, если вы не выбрали контракт, в соответствии с которым частичные данные являются ошибочными и, следовательно, 40x.